go through making lots of the docs more lint happy #10342
DO NOT DELETE THIS TEXT
If you would like to test this pull request then please run:
No actual documentation changes. Went through making various formatting making mdl scream less about the.
Left the header start as they are, even though it does not fix issues with mdl not being happy with them as I am not sure if those are relevant or not off hand.