Adding named anchors in docs

[galgalesh]

Just a note that I’ve been explicitly adding these to every heading that I want to link to, the appstream heading as an example:

Using external metadata

To help avoid unnecessary duplication, and for convenience, Snapcraft can process and incorporate external metadata from within snapcraft.yaml by using parse-info within a part and a corresponding adopt-info key. For example, the following snapcraft.yaml will parse a file called metadata-file. Snapcraft will attempt to extract version, summary and description metadata for the snap, all of which are mandatory: name: my-snap-name adopt-info: part-with-metadata parts: part-with-metadata: p…

This is what it looks like in code:

<h3 id='heading--appstream'>AppStream<sup><a href=#heading--appstream>⚓</a></sup></h3>

(For some reason, browsers seem to find the position of the link better if it’s the id of a header instead of the name of a link.)

The advantage of doing these explicitly is that they don’t break when you change the heading name. However I understand that readers/users also want to link to content and won’t think of creating an anchor themselves…