added some more examples and documentation