Add CI linting for Markdown files

[samdbmg]

Details

Adds linting of Markdown files in the repository using https://github.com/DavidAnson/markdownlint-cli2

Might make it a bit easier to keep the docs neat (and it found a misnumbering for me!). Thoughts?

Pivotal Story

Story URL: Done as part of https://www.pivotaltracker.com/story/show/186644493

Related PRs

Follows #15

Links to external test runs/working deployment

N/A

Submitter PR Checks

(tick as appropriate)

• Added bbc/rd-apmm-cloudfit team as a reviewer
• PR completes task/fixes bug
• Tests exercise code appropriately
• New features and API breaks are flagged in commit messages using magic strings
• Repo maintainer is notified that a release is required
• Documentation updated (README, Confluence, Docstrings, API spec, Engineering Guide, etc.)
• Downstream repos have been checked for potential breaks & fixed as needed
• APIs/UIs/CLIs updated as required
• PR added to Pivotal story
• Follow-up stories added to Pivotal
• Any temporary code/configuration removed (e.g. test deployment environment, temporary commontooling branch)
• Any pins against pre-releases have been removed

Reviewer PR Checks

(tick as appropriate)

• PR completes task/fixes bug
• Tests exercise code appropriately
• Design makes sense, and fits with our current code base
• Code is easy to follow
• PR size is sensible
• Commit history is sensible and tidy

Info on Cloudfit PRs

• The checks above are guidelines. They don't all have to be ticked, but they should all have been considered.
• For more details on how to asses PRs, see: https://github.com/bbc/rd-apmm-docs-ways-of-working/blob/master/workflow/PRChecklist.md

[robwadge]

LGTM - good idea to add linting checks

[samdbmg]

I've made some fairly substantial changes to how this works (moving from an Action to a Docker image) so I can use the custom one-sentence-per-line rule - requesting re-review as a result

[j616]

LGTM

[robwadge]

Changes to linting LGTM