added helpful notes to example