add some documentation in code examples