[docs] Headings should be linkable

[atomiks]

Docs feedback

It's not possible to click headings to link to subsections of a page. Headings should have <a> tags around them with id hashes.

[colmtuite]

You can click the quick nav link

[atomiks]

You can click the quick nav link

I forgot that was possible, doesn't seem easily discoverable + doesn't work on narrow viewports/mobile?

[imMatheus]

Still feel like the headers should be linkable IMO, also, would be fairly easy to add no? I could make a quick PR for it

[mnajdova]

I noticed this and forgot to mention it. The most common use-case for me is to click on the header and share a link with someone. I am already looking at the title, finding it again in the table of content seems like an overkill.

[mj12albert]

The most common use-case for me is to click on the header and share a link with someone

This is also a big use-case for me, e.g. adding links to GH comments while doing support on-the-go

I think API docs generally have this, examples of some docs I looked at recently:

Radix docs:

radix-select.mp4

Ariakit docs:

The subcomponents in the anatomy are links so that counts? I like that individual props are linkable too

ariakit-select.mp4

RA docs:

The links exist but they are invisible on mobile...

ra-select.mp4

Fastify:

fastify.mp4