More documentation improvements

Mostly in language and grammar departments. I suck at writing, and tend
to add too much bullshit to what I am trying to say. Blech.