- address a markdown accessibility issue

nits:
- accept most markdownlint fixes e.g. about using consistent list characters
- correct a few spelling errors