Skip to content

Fix duplicate Highlights anchor in 0.86 release post#5134

Merged
huntie merged 1 commit into
mainfrom
blog/fix-0.86-highlights-toc
Jun 15, 2026
Merged

Fix duplicate Highlights anchor in 0.86 release post#5134
huntie merged 1 commit into
mainfrom
blog/fix-0.86-highlights-toc

Conversation

@fabriziocucci

@fabriziocucci fabriziocucci commented Jun 15, 2026

Copy link
Copy Markdown
Contributor

Summary

The 0.86 release post showed two "Highlights" links in the sidebar table of contents, pointing to #highlights and #highlights-1.

The cause is two headings that both slug to highlights:

  • the pre-truncate teaser ### Highlights
  • the ## Highlights section heading after the truncate marker

Docusaurus deduped the second anchor to #highlights-1. In 0.86 the teaser only lists "Highlights", so the two entries sit adjacent in the sidebar and the duplication is obvious.

Fix

Promote the teaser to ## Highlights and drop the now-redundant ## Highlights section heading after the truncate marker. The highlight subsections (###) then nest under the single Highlights heading.

-### Highlights
+## Highlights

 - [A New Home for React Native](...)
 - [Edge-to-Edge on Android](...)
 - [React Native DevTools Improvements](...)

 {/* truncate */}

-## Highlights
-
 ### A New Home for React Native

Test plan

Verified against a local yarn build:

  • only one id=highlights anchor is generated (no highlights-1)
  • the sidebar shows a single Highlights with A New Home for React Native, Edge-to-Edge on Android, and React Native DevTools Improvements nested underneath it
  • the teaser links (#a-new-home-for-react-native, #edge-to-edge-on-android, #react-native-devtools-improvements) all resolve

@meta-cla meta-cla Bot added the CLA Signed label Jun 15, 2026
@fabriziocucci fabriziocucci marked this pull request as draft June 15, 2026 14:54
@fabriziocucci fabriziocucci force-pushed the blog/fix-0.86-highlights-toc branch 2 times, most recently from de25f59 to 5ed8de1 Compare June 15, 2026 15:29
The pre-truncate teaser "### Highlights" and the "## Highlights"
section heading both slug to "highlights", so Docusaurus generated two
table-of-contents entries (#highlights and #highlights-1).

Promote the teaser to "## Highlights" and drop the now-redundant
"## Highlights" section heading after the truncate marker. The highlight
subsections nest under the single Highlights heading, leaving one
#highlights anchor in the sidebar.
@fabriziocucci fabriziocucci force-pushed the blog/fix-0.86-highlights-toc branch from 5ed8de1 to 286e1b9 Compare June 15, 2026 16:13
@fabriziocucci fabriziocucci requested review from Copilot and cortinico and removed request for Copilot June 15, 2026 16:23
@fabriziocucci fabriziocucci marked this pull request as ready for review June 15, 2026 16:24
@huntie huntie merged commit bd6d67c into main Jun 15, 2026
9 checks passed
@huntie huntie deleted the blog/fix-0.86-highlights-toc branch June 15, 2026 16:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants