SlowRiot authored Jan 07, 2022 and freetrader committed Jan 07, 2022

One of a multi-part series of changes to improve markdown code quality,
primarily driven by feedback from codeclimate's markdownlint plugin.
This MR resolves markdown issues with header styles:

- All files must begin with a top-level header
- There must only be one top-level header
- Header styles must be consistent throughout a file - both SETEXT and
  ATX styles are acceptable, but must be the same.  Where more than two header
  levels are present, SETEXT is replaced with ATX for consistency
  (as third-level and below headers don't exist in SETEXT style).
- No trailing punctuation in headers
- There must be whitespace surrounding a header

This also resolves the following miscellaneous issues:

- Fixing quotes for correct rendering

Test plan
---------

- review document changes
- Run codeclimate locally to verify rule violations have been addressed:

    docker run --interactive --tty --rm --env CODECLIMATE_CODE="$PWD" --volume "$PWD":/code --volume /var/run/docker.sock:...