Skip to content

Conversation

gaearon
Copy link
Collaborator

@gaearon gaearon commented Jul 28, 2025

See #34021 (comment).

The purpose of the changelog is to communicate to React users what changed in the release.

Therefore, it is important that the changelog is written oriented towards React end users. Historically this means that we omit internal-only changes, i.e. changes that have no effect on the end user behavior. If internal changes are mentioned in the changelog (e.g. if they affect end user behavior), they should be phrased in a way that is understandable to the end user — in particular, they should not refer to internal API names or concepts.

We also try to group changes according to the publicly known packages.

In this PR:

  • Make fix: rename bottom stack frame #33680 an actual link (otherwise it isn't linkified in CHANGELOG.md on GitHub).
  • Remove two changelog entries listed under "React" that don't affect anyone who upgrades the "React" package, that are phrased using terminology and internal function names unfamiliar to React users, and that seem to be RN-specific changes (so should probably go into the RN changelog that goes out with the next renderer sync that includes these changes).

@github-actions github-actions bot added the React Core Team Opened by a member of the React Core Team label Jul 28, 2025
@gaearon gaearon requested review from jackpope and eps1lon July 28, 2025 16:25
@react-sizebot
Copy link

Comparing: 101b20b...aae19d4

Critical size changes

Includes critical production bundles, as well as any change greater than 2%:

Name +/- Base Current +/- gzip Base gzip Current gzip
oss-stable/react-dom/cjs/react-dom.production.js = 6.68 kB 6.68 kB = 1.83 kB 1.83 kB
oss-stable/react-dom/cjs/react-dom-client.production.js = 530.70 kB 530.70 kB = 93.70 kB 93.70 kB
oss-experimental/react-dom/cjs/react-dom.production.js = 6.69 kB 6.69 kB = 1.83 kB 1.83 kB
oss-experimental/react-dom/cjs/react-dom-client.production.js = 655.25 kB 655.25 kB = 115.40 kB 115.40 kB
facebook-www/ReactDOM-prod.classic.js = 675.13 kB 675.13 kB = 118.75 kB 118.75 kB
facebook-www/ReactDOM-prod.modern.js = 665.56 kB 665.56 kB = 117.11 kB 117.11 kB

Significant size changes

Includes any change greater than 0.2%:

(No significant changes)

Generated by 🚫 dangerJS against aae19d4

@gaearon
Copy link
Collaborator Author

gaearon commented Jul 28, 2025

If we want to signal the change to third party renderers, we could keep those but place them under "React Reconciler", like done in past releases that changed the host configs. That is, if we assume that third party renderers would be affected by them.

@gaearon gaearon merged commit 904989f into main Jul 28, 2025
246 of 247 checks passed
@gaearon gaearon deleted the gaearon-patch-1 branch July 28, 2025 16:32
@jackpope
Copy link
Member

The dropped changes are specific to persisted mode, which as far as I know is largely RN.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed React Core Team Opened by a member of the React Core Team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants