add more example code
improve documentation some more