truly trivial doc followups

- sync the docs to match some recent PRs
- formatting mistakes
- capitalization
- quoting
Merge pull request #2474 from rolandwalker/doc_nits

truly trivial doc followups