Multiple corrections to the docs

Fixed a few typos, broken-links, etc

Fixes #707, fixes #760 and fixes #724