Normalize code examples, clarify and fix typos in the documentation. Closes GH-28.
Update readme