More doc changes.

Some content changes inspired by external developer feedback, plus some
corrections of long-standing typos.
1 file changed