Duplicate links to sections in docs

Requested Update

Description

The syntax we are using to produce stable links to sections in our docs is cumbersome. We're currently doing this in many locations:

(pluginify_create)=

## pluginify create

{ref}`pluginify create <pluginify_create>`

What this does:

• (pluginify_create)= creates a stable anchor to this location whose URL won't change, even if the heading title changes.

• pluginify create creates a heading which also implicitly creates an anchor. However, if this heading were to change, the anchor and URL would change, breaking any existing references.

• {ref}pluginify create <pluginify_create> creates a link whose text reads "pluginify create" directly below the heading. This allows easily sharing the stable link but is ugly.

The result would look like this:

pluginify create

pluginify create

where the first line would also have a link symbol next to it, pointing to the unstable header reference and the second line is a link back to the (pluginify_create)= anchor.

It would be nice to update our docs such that the link symbol points back to the stable reference rather than an unstable link.

Recommended practice is to use:

## pluginify delete```

This creates one, link, but if the heading were updated to not match the anchor, would create two links. The anchor is stable while the heading is not. Unfortunately, that means that, if someone provides the URL provided by the link symbol, they are providing the unstable link.

Other options are to require that all headings use explicit syntax like this:

```(pluginify_delete)=
## pluginify delete {#pluginify_delete}```

Or edit the theme template to automatically use the explicit link if it exists.

### Checklist for Completion
* [ ] <!--- Include a list of steps that must be complete in order to close this Issue --->

Start by reviewing the repeated anchor and reference patterns in the documentation, then inspect the theme template that generates the heading link symbol. Compare the proposed explicit-anchor and template approaches, and confirm that the chosen approach produces a single stable link for each documented section without duplicate links.