Improve markdown and fix links that don't render correctly

What does this MR do?

Fixes a link not rendering properly and, therefore, breaking.

Also improved Markdown and text.

Author's checklist

• Apply the correct labels and milestone
• Port the MR to EE (or backport from CE): always recommended, required when the ee-compat-check job fails

Review checklist

• Your team's review (required)
• PM's review (recommended, but not a blocker)
• Technical writer's review (required)
• Merge the EE-MR first, CE-MR afterwards