minor misspelling/grammar/formatting updates

[smithrobs]

• normalize hyphenation
• fix misspellings
• minor grammar updates
• line ending/spacing cleanup

[rshade]

I am merging this since its only docs. I don't see how the tests could be failing it.