Improve some text in the docs. Closes #340