Grammar etc. fixes in the docs

Fixes gh-654