Copy edits in the documentation.

- README length reduced by about 100 words
- Code examples that were wrong are now fixed
- Typos changed