extending the examples
updating the docs