added some more usage examples & docs