Docs: Fixing up documentation spacing

There were some minor issues where extra spaces would be added, indentations
wouldn't quite match up, etc. This tidies and standardizes those in the
general case.

Fixes https://tickets.puppetlabs.com/browse/RAZOR-213
Docs: Improving punctuation and spacing

Punctuation and other minor fixes for individual command help messages.

Fixes https://tickets.puppetlabs.com/browse/RAZOR-270