adding some more examples and documentation