A few documentation fixes

Typos fixed and a few style issue. Note that one area I didn't touch is american-vs-british english - the docs seem to have a mixed mode, but mostly british.