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
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.

1 participant