Documentation editorial update

This is a first editorial pass through things (grammar, spelling,
etc.) as well as putting to page a lot of the style guide suggestions.
But it does also include some section reworkings, and more substantial
reordering of the step-by-step examples (e.g. the commented-as-clunky
Security Options guides).
doc: fix TSHttpConnectWithPluginId section headers