Docs: Improving punctuation and spacing

Punctuation and other minor fixes for individual command help messages.

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