Markdown Linting is enable but is currently failing

[BrianSidebotham]

The Markdown lint configuration needs deciding upon and the Markdown needs editing to pass the required configuration