Misc documentation updates

[tunetheweb]

Brief summary of the change made

Fixes #1607
Fixes #1309

Are there any other side effects of this change that we should be aware of?

Nope

Pull Request checklist

• Please confirm you have completed any of the necessary steps below.

• Included test cases to demonstrate any code changes, which may be one or more of the following:

  • .yml rule test cases in test/fixtures/rules/std_rule_cases.
  • .sql/.yml parser test cases in test/fixtures/dialects (note YML files can be auto generated with python test/generate_parse_fixture_yml.py or by running tox locally).
  • Full autofix test cases in test/fixtures/linter/autofix.
  • Other.

• Added appropriate documentation for the change.

• Created GitHub issues for any relevant followup/future enhancements if appropriate.

[codecov]

Codecov Report

Merging #1644 (a101a5a) into main (3e14809) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##              main     #1644   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files          133       133           
  Lines         9250      9250           
=========================================
  Hits          9250      9250           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 3e14809...a101a5a. Read the comment docs.

[tunetheweb]

Think this is ready to merge if you can give your approval @barrywhart ? GitHub won't let me merge without it.

Feedback addressed