Documentation linting issues

[mikelittle]

This ticket addresses the issues raised by the documentation linting

composer dev-tools lintdocs all -l packages/core

File Issues:

None

Markdown issues:

Linting: 4 file(s) Summary: 126 error(s)

Style issues:

22 errors, 0 warnings and 0 suggestions in 4 files.