Various documentation fixes.

Cherry picking of fixes from #976 (and one of two from me).

#976 contains both American English fixes (which are controversial) and typos fixes that should be merged. This PR brings the second category of fixes in. All thanks to @delphij for the hard work.