Clean up whitespace across the docs

Problem to solve

A couple times recently while reviewing MRs I kept running into lists with incorrect indentation or other alignment issues. I decided to do a few greps and see if this was widespread, and it was. I'll use this issue to track the MRs created for the alignment work.

Regex examples:

• Look for top-level unordered lists items with no nesting on the next line: ^(-) .*\n(\w|\[|`|'|"|\()
• Look for unordered list items with the same problem as above, but at any nesting depth: ^((.*)-) .*\n(\2)(\w|\[|`|'|"|\()

Further details

Proposal

Who can address the issue

Other links/references