Skip to content

Overhaul releases docs, add branches page - #5189

Merged
huntie merged 1 commit into
react:mainfrom
huntie:overhaul-releases-pages
Jul 27, 2026
Merged

Overhaul releases docs, add branches page#5189
huntie merged 1 commit 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

Comment thread website/releases/branches.md
Comment thread website/releases/branches.md Outdated
@cortinico

Copy link
Copy Markdown
Contributor

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

Yup this should remain. It should land to the top level of this new section.

Comment thread website/releases/branches.md Outdated
Comment thread website/releases/overview.md Outdated
@cortinico

Copy link
Copy Markdown
Contributor
  • The Release Levels page (user guidance on Canary etc. feature level opt-in) remains, for now, under Docs (relocated to Docs > Guides > Workflow).

Why was this not moved as well?

@huntie

huntie commented Jul 27, 2026

Copy link
Copy Markdown
Member Author

Why was this not moved as well?

@cortinico For now, just because IMO this sits better in the versioned regular docs — it's instructions about app bootstrap code specific to a given RN version. i.e. "How to opt into a feature (flags) level" rather than the other pages being "This is what and how RN release versions are"

@huntie

huntie commented Jul 27, 2026

Copy link
Copy Markdown
Member Author

reactnative.dev/releases [...] is broken after the changes. We should update it or remove it.

@Simek @cortinico Addressed by the _redirects file, should be handled for already under Netlify (and also updated Vercel redirects artifact).

@huntie

huntie commented Jul 27, 2026

Copy link
Copy Markdown
Member Author

Docs version page stretches to the full viewport width

@Simek Intentional/harmless. This /versions page is the prev, unchanged route — not technically a docs page and doesn't need a jumpable outline nav.

Maybe continuity over consistency 😅, either would do.

@huntie
huntie force-pushed the overhaul-releases-pages branch from 2bea217 to 68b4163 Compare July 27, 2026 10:30
@huntie

huntie commented Jul 27, 2026

Copy link
Copy Markdown
Member Author

@Simek Changes addressed, thanks!

Chunkier but better-fitting table 👍🏻

image

@huntie
huntie force-pushed the overhaul-releases-pages branch from 68b4163 to 1fe9442 Compare July 27, 2026 11:24
@Simek

Simek commented Jul 27, 2026

Copy link
Copy Markdown
Collaborator

Fix for Version page stretching

Add in showcase.tsx Layout element:

wrapperClassName="showcase-wrapper"

change in showcase.scss:

.plugin-pages .main-wrapper {
// to 
.showcase-wrapper.main-wrapper {

It looks like Docusaurus threats the Version page as a custom one + we inject showcase styles on all pages 😅 Will look at this problem separately after the merge.

@Simek Simek left a comment

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.

With the version page stretch issue address LGTM form the web app perspective. 👌

@huntie
huntie force-pushed the overhaul-releases-pages branch from 1fe9442 to 9fbc510 Compare July 27, 2026 12:24
@huntie
huntie force-pushed the overhaul-releases-pages branch from 9fbc510 to 38f3134 Compare July 27, 2026 12:25
@huntie
huntie enabled auto-merge (squash) July 27, 2026 12:26
@huntie
huntie merged commit 889fa09 into react:main Jul 27, 2026
8 checks passed
@huntie
huntie deleted the overhaul-releases-pages branch July 27, 2026 12:29
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.

3 participants