Vet doc files

[zerospiel]

Tidy up all the *.md files according to common lint rules

[a13x5]

What linter was used? Lazy ordered lists are atrocious when you want to actually refer step numbers. I don't see it in our case, but if it will be enforced I would prefer normal ordering.

[zerospiel]

@a13x5 the rules provided by the VSCode extension have been followed