Avoid putting numbers in Markdown headings
Something to consider, I noticed this today.
We have numbers in Markdown headings in the installation guide, patch guide and upgrade guides all over.
I see the point in this, but when we add for example a new requirement (we recently introduced Go in the installation guide), numbers shift hence documentation anchor links shift too.
I see that pandoc which is now used for generating doc.gitlab.com strips the numbers, but if we ever migrate to another static generator solution, we may have problems with dead links.