Request: stable sub-heading IDs on combined configuration settings pages

[kenjenkins]

Page: https://www.pomerium.com/docs/reference/cookies (as one example)

What's incorrect or missing

The auto-generated heading IDs for all the "How to configure" and "Examples" sub-headers are numbered like -1, -2, -3:

• https://www.pomerium.com/docs/reference/cookies#how-to-configure
• https://www.pomerium.com/docs/reference/cookies#how-to-configure-1
• https://www.pomerium.com/docs/reference/cookies#how-to-configure-2
• https://www.pomerium.com/docs/reference/cookies#how-to-configure-3

If I send someone a link such as How to configure Cookie HTTP Only and we later add a new option before this one, my link will no longer point to the 'Cookie HTTP Only' section.

What's the resolution?

Should we set these IDs explicitly? For example:

### How to configure {#cookie-name-how-to-configure}

(cf. https://docusaurus.io/docs/next/markdown-features/toc#heading-ids)

Alternatively, should these not be linkable at all? I think we could manually insert <h3> tags instead:

<h3>How to configure</h3>

If I understand correctly, then they wouldn't be linkable, and they wouldn't appear in the right-hand table-of-contents, which is looking a little cluttered to me: