added notes and samples file