Documentation updates

I have proofread the documentation and have come up with some potential updates. Some are simple fixes and others need more consideration. 

These patches, among other things, fix points 4 and 5 of @siteswhar 's notes in #488.