truly trivial doc followups

- sync the docs to match some recent PRs
- formatting mistakes
- capitalization
- quoting