Minor documentation cleanup

This commit fixes some typos and grammar mistakes. It
also fixes some of the long text lines and generally
makes the documentation more readable.
Merge pull request #782 from AgathaTheWitch/master

Minor documentation cleanup