Fix a few typos and make docs a bit more readable.
Merge pull request #744 from dpb587/patch-1

Fix a few typos and make docs a bit more readable.