more docs, examples, formatting