[Documentation] More documentation fixes

- Improve readability of first two levels of headings
- Add .md suffix to documentation files to trigger markdown formatting
  on GitHub.