Improve documentation by:

- Fixing MyST errors
- Fixing broken links
- Correcting misspellings
- Correct a few style issues, such as sentence-case for headings

A lot more work needs to be done, specifically adding terms to the Vale dictionary and improving the style to use inline literals instead of bold, which will also cut down on the number of terms that Vale flags.

Author: stevepiercy