improved examples, more docs