Fix documentation markdown
Improve first section of documentation
Minor corrections to docs
Let docs menu item point directly at README.md