Change docs markdown linter from mdl to markdownlint

What does this MR do?

This changes the docs markdown lint test from ruby mdl to node markdownlint, and updates docs as required to pass the improved tests.

Related issues

Related to &221
Related to #4537 (closed)