including updates to notes and sample code