Assorted minor documentation updates.

* Update example response bodies to be mostly valid JSON.
* Replace most real people's email addresses with fake ones.
* Clarify a few things.
* Fix typos.