add link icon to section headers

[kaitlynmichael]

DOC-5370
Suggestion from #ask-docs https://redis.slack.com/archives/C02QBGV0LUS/p1750859040153789

[rrelledge]

Thank you! This seems to work great on most pages I've checked. The only issue I've found so far is that the links that should appear in the "On this page" ToC on the right-hand side have disappeared for some pages that include embeds.

Before this change: https://redis.io/docs/latest/operate/rs/references/supported-platforms/
Versus after this change: https://redis.io/docs/staging/link-icon-poc/operate/rs/references/supported-platforms/

I think this issue might only affect pages where headers are included within the embed content, because other pages with embeds like https://redis.io/docs/staging/link-icon-poc/operate/rs/installing-upgrading/quickstarts/redis-enterprise-software-quickstart/ seem to be fine.

[andy-stark-redis]

Nice improvement :-) Just a couple of thoughts:

• Maybe it's just me, but the link icon seems a bit too far from the end of the heading. Maybe bring it in a bit closer and align the bottom of the icon with the text baseline? (Very minor, though.)
• The tooltip that says "Copied!" doesn't seem to appear very reliably (I think you can only see it if you hover over the icon shortly after you've clicked it). Another option for this that you sometimes see (eg, here) is to jump to the corresponding heading when you click the icon. This copies the link but also changes the hash in the URL bar to give confirmation. Not sure if this is any better but it might be worth trying.

[cmilesb]

Another example RE: Embed header weirdness -

Compatibility page - before: https://redis.io/docs/latest/operate/rs/references/compatibility
Compatibility page - after: https://redis.io/docs/staging/link-icon-poc/operate/rs/references/compatibility/

It's also on the Cloud page, but they're basically the same. Any headers in that embed file don't show in the right-side TOC.

[kaitlynmichael]

@rrelledge and @andy-stark-redis, I had augmented make some edits based on your feedback. It looks like it fixed Andy's suggestions, but the TOC weirdness Rachel and @cmilesb pointed out is still happening

[rrelledge]

@kaitlynmichael @cmilesb I pushed a fix for the "On this page" ToC for embeds. It seems like it's working now.

[cmilesb]

I think that worked, @rrelledge - looks good to me.