Follow-up from "Docs: tidy up phrasing after merge with no TW review"

The following discussion from !32332 (merged) should be addressed:

• @hfyngvason started a discussion: (+1 comment)

  For a follow up: Maybe this can be added to the linter?

The question:

don't think we can tell Markdownlint to require only yaml instead of yml, but @marcel.amirault will be the one to know.