add some notes and examples