Docs Markdown Cleanup - Part 2

Continuing the work I did in 2341e9b. Trying to make the docs actually readable, and then try to improve upon them.