adding some more notes and examples