add some more examples, doco