Fix docs-lint job that was missing half the docs

What does this MR do?

Fixes the docs-lint pipeline job that was broken in !26379 (merged)

Also had to fix the docs that were introduced with markdown that will fail once the test is fixed.