Documentation cleanup

Fixes grammar/punctuation mistakes, makes formatting more consistent, and rephrases a few sentences that felt awkward.