add section for documenting example code for common tasks, and add some of the examples; @raix feel free to add more
minor clarifications