I often find myself trying to refer to a particular section in the Snapcraft docs and find that there’s no named anchors there (i.e. those allowing a
#some-heading in the URL to scroll the browser down there).
As an example, GitHub does this automatically by creating a named anchor from the heading text itself. That would be a huge gain in itself. It also displays a icon on hover on the left of the heading to let the viewer know there’s an anchor and let them get the link for it.
Where applicable, explicit named anchors may also be used in Markdown:
<a name="content"></a>Content. [And a link to it](#content)
Which translates to:
It’s trickier to add in code blocks, but also possible:
Unfortunately syntax highlighting currently broken: