adding examples and documentation