Skip to content

Overhaul releases docs, add branches page#5189

Open
huntie wants to merge 3 commits into
react:mainfrom
huntie:overhaul-releases-pages
Open

Overhaul releases docs, add branches page#5189
huntie wants to merge 3 commits into
react:mainfrom
huntie:overhaul-releases-pages

Conversation

@huntie

@huntie huntie commented Jul 25, 2026

Copy link
Copy Markdown
Member

Note

Stacked PR: Depends on #5186, #5187, #5188.

Summary

A new, stronger home for Releases information on reactnative.dev.

  1. The versioning/release pages had become somewhat hidden under Docs > Guides and an expandable side nav section. The refreshed Releases Overview page now presents essential info in a single view, accessible from a top-level Releases nav item.

    image
  2. For framework/library maintainers, we've had no central source for what each release branch contains. The new Branches page introduces an initial table of platform components by branch, inspired by Chromium Dash.

    image
  3. Revise all content. Generally, the Releases Overview page retains everything a first-timer would need to understand. Cut out/relocate passive information such as number of intended releases/philosophy.

    • The Versioning Policy core guidance is untouched.

Deliberate choices

  • Separated from the docs — in future, potentially a dynamic section of the site (out of scope today).
  • The Release Levels page (user guidance on Canary etc. feature level opt-in) remains, for now, under Docs (relocated to Docs > Guides > Workflow).

Other changes

  • Add _redirects entries mapping the old /docs/releases/* URLs to the new locations, and fix two stale versioning-policy redirects.
  • Table styling: Both release tables get a shaded, bold row-header column and single-line cells that scroll horizontally within their bordered wrapper.

Test Plan

Screen.Recording.2026-07-25.at.18.11.49.mov
  • ✅ Tour of new Releases pages
  • ✅ Docs version switcher navigates to /versions within our new hierachy
  • Switch to 0.85 docs (old versions) (left hand side)
    • ✅ Releases section in Docs sidebar (previous state, unchanged)
    • ✅ All pages present (previous state, unchanged)

@meta-cla meta-cla Bot added the CLA Signed label Jul 25, 2026
@huntie
huntie marked this pull request as ready for review July 25, 2026 17:23
@huntie
huntie force-pushed the overhaul-releases-pages branch from 3a2f871 to 2bea217 Compare July 25, 2026 17:54
@Simek

Simek commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

The versioning/release pages had become somewhat hidden under Docs > Guides and an expandable side nav section.

Just FYI, the page was also available as top level link: https://reactnative.dev/releases which is broken after the changes. We should update it or remove it.

@Simek

Simek commented Jul 26, 2026

Copy link
Copy Markdown
Collaborator

Docs version page stretches to the full viewport width, while the rest of pages are contained in the layout.

Screenshot 2026-07-26 124816


## Platform Versions

<div className="table-scroll">

@Simek Simek Jul 26, 2026

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Scrollable table even at full width seems a bit meh, maybe we can add <br/> in the last column between inline code block version and chrome version text?

Image

Also the .table-scroll wrapper seems to cause some issues. Currently the tables become automatic scrollable when content does not fit, i.e. on mobile.


<div className="table-scroll">

| Branch | React<a href="https://github.com/facebook/react"><IconExternalLink /></a> | Hermes<a href="https://github.com/facebook/hermes"><IconExternalLink /></a> | Hermes V1<a href="https://github.com/facebook/hermes"><IconExternalLink /></a> | Yoga<a href="https://github.com/facebook/yoga"><IconExternalLink /></a> | React Native DevTools frontend<a href="https://github.com/react/react-native-devtools-frontend"><IconExternalLink /></a> |

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit, all those external links should have target="blank".

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