Skip to content

Navigation Menu

Sign in
Sign up

Sync with react.dev @ f3d9794f - #1239

Open
react-translations-bot wants to merge 234 commits into
main from
sync-f3d9794f
Open

Sync with react.dev @ f3d9794f #1239
react-translations-bot wants to merge 234 commits into
main from
sync-f3d9794f

Conversation

@react-translations-bot

@react-translations-bot react-translations-bot commented Sep 7, 2026

Copy link
Copy Markdown
Collaborator

This PR was automatically generated.

Merge changes from react.dev at f3d9794

The following files have conflicts and may need new translations:

Please fix the conflicts by pushing new commits to this pull request, either by editing the files directly on GitHub or by checking out this branch.

DO NOT SQUASH MERGE THIS PULL REQUEST!

Doing so will "erase" the commits from main and cause them to show up as conflicts the next time we merge.

dimatitov and others added 30 commits June 2, 2025 11:34
...nce (#7833)
* fix link from ARIA dialog-modal
* chore: trigger CLA recheck
Adding the React Community for Rajasthan India
Some grammar fixes, and language clarifications
... when that function is used by a Client Component (#7746)
This API is now under "Legacy APIs" and should probably no longer be listed as a "modern API".
* delete provider
* Fix NavContext usage in Talks component
* Fix TocContext and LanguagesContext usage in Page component
* Fix IllustrationContext usage in IllustrationBlock component
* Fix LevelContext and TasksContext usage in managing-state.md
* Fix ThemeContext and Context usage in MyApp component
* Fix HighlightContext usage in List component
* Fix ThemeContext usage in MyApp component
* Fix ErrorDecoderContext usage in ErrorDecoderPage component
* Fix ThemeContext usage in MyPage and MyApp components
* Fix ThemeContext usage in MyApp component
* Fix useContext documentation to correct context provider references
* Fix context provider references in createContext documentation
* prettier
* Update src/content/reference/react/createContext.md
---------
Co-authored-by: Ricky <rickhanlonii@gmail.com>
Update to be in line with the recommended way from React 19.
Docs https://react.dev/blog/2024/12/05/react-19#context-as-a-provider
---------
Co-authored-by: Ricky <rickhanlonii@gmail.com>
This PR corrects a small typo in the React documentation, changing "`refs`" to "`ref`s" for accuracy and consistency.
Fix typo in the 'Step 3: Use context anywhere in the tree' section by changing TaskContext to TasksContext for accuracy.
While rewriting the compiler docs I happened to notice some deadlinks. This PR adds a new `yarn deadlinks` script to identify all deadlinks.
I decided to make this a script for now for simplicity but in the future could be ported to an ESlint rule.
The script handles:
- [x] checks images correctly (images are stored in /public but links can omit the /public)
- [x] looks up React error codes for dynamic error pages
- [x] lints links to contributors and uses URL from acknowledgements page if the member is no longer active on the core team
- [x] special injected anchor tags like #recap and #challenges
Example:
```
yarn run v1.22.22
$ node scripts/deadLinkChecker.js
Checking 177 markdown files...
Fetched 552 React error codes
src/content/learn/add-react-to-an-existing-project.md:23:58
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/add-react-to-an-existing-project.md:27:45
 Link text: benefit from the best practices
 URL: /learn/start-a-new-react-project#can-i-use-react-without-a-framework
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/add-react-to-an-existing-project.md:152:269
 Link text: a React framework
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/synchronizing-with-effects.md:735:18
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/typescript.md:16:3
 Link text: Common types from `@types/react`
 URL: /learn/typescript/#useful-types
 ✗ Target file not found for: /learn/typescript/
src/content/learn/typescript.md:17:3
 Link text: Further learning locations
 URL: /learn/typescript/#further-learning
 ✗ Target file not found for: /learn/typescript/
src/content/learn/typescript.md:23:5
 Link text: production-grade React frameworks
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/you-might-not-need-an-effect.md:29:399
 Link text: frameworks
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/you-might-not-need-an-effect.md:754:106
 Link text: frameworks
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/your-first-component.md:218:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/ViewTransition.md:146:248
 Link text: reveal content
 URL: /link-to-suspense-below
 ✗ Target file not found for: /link-to-suspense-below
src/content/reference/react/captureOwnerStack.md:60:94
 Link text: `errorInfo.componentStack` in `onUncaughtError`
 URL: /reference/react-dom/client/hydrateRoot#show-a-dialog-for-uncaught-errors
 ✗ Anchor #show-a-dialog-for-uncaught-errors not found in reference/react-dom/client/hydrateRoot.md
src/content/reference/react/forwardRef.md:9:65
 Link text: here
 URL: /blog/2024/04/25/react-19#ref-as-a-prop
 ✗ Target file not found for: /blog/2024/04/25/react-19
src/content/reference/react/use.md:315:24
 Link text: Server Component
 URL: /reference/react/components#server-components
 ✗ Anchor #server-components not found in reference/react/components.md
src/content/reference/react/useEffect.md:899:67
 Link text: if you use a framework,
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/useEffect.md:1051:18
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/useEffect.md:1736:92
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/useInsertionEffect.md:136:65
 Link text: non-blocking update,
 URL: /reference/react/useTransition#marking-a-state-update-as-a-non-blocking-transition
 ✗ Anchor #marking-a-state-update-as-a-non-blocking-transition not found in reference/react/useTransition.md
src/content/reference/react-dom/createPortal.md:53:76
 Link text: key.
 URL: /learn/rendering-lists/#keeping-list-items-in-order-with-key
 ✗ Target file not found for: /learn/rendering-lists/
src/content/reference/react-dom/index.md:24:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/index.md:51:3
 Link text: `unmountComponentAtNode`
 URL: /reference/react-dom/unmountComponentAtNode
 ✗ Target file not found for: /reference/react-dom/unmountComponentAtNode
src/content/reference/react-dom/preinit.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/preinitModule.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/preload.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/preloadModule.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/directives.md:13:36
 Link text: bundlers compatible with React Server Components
 URL: /learn/start-a-new-react-project#full-stack-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/server-components.md:7:34
 Link text: React Server Components
 URL: /learn/start-a-new-react-project#full-stack-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/server-functions.md:198:28
 Link text: `useActionState`
 URL: /reference/react-dom/hooks/useFormState
 ✗ Target file not found for: /reference/react-dom/hooks/useFormState
src/content/reference/rsc/server-functions.md:222:28
 Link text: `useActionState`
 URL: /reference/react-dom/hooks/useFormState
 ✗ Target file not found for: /reference/react-dom/hooks/useFormState
src/content/reference/rsc/use-client.md:44:77
 Link text: compatible bundlers
 URL: /learn/start-a-new-react-project#full-stack-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/use-server.md:98:54
 Link text: serializable props
 URL: /reference/rsc/use-client#passing-props-from-server-to-client-components
 ✗ Anchor #passing-props-from-server-to-client-components not found in reference/rsc/use-client.md
src/content/reference/react-dom/client/createRoot.md:212:278
 Link text: using a framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/client/index.md:7:185
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/components/common.md:919:89
 Link text: check out more examples.
 URL: /reference/react/useRef#examples-dom
 ✗ Anchor #examples-dom not found in reference/react/useRef.md
src/content/reference/react-dom/components/form.md:39:23
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/form.md:233:63
 Link text: reference documentation
 URL: /reference/react/hooks/useOptimistic
 ✗ Target file not found for: /reference/react/hooks/useOptimistic
src/content/reference/react-dom/components/input.md:33:24
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/link.md:33:23
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/meta.md:33:23
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/option.md:39:25
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/progress.md:33:27
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/script.md:34:25
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/select.md:39:25
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/style.md:33:24
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/textarea.md:33:27
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/title.md:33:24
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/server/index.md:7:182
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/static/index.md:7:146
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2023/03/16/introducing-react-dev.md:45:5
 Link text: API Reference
 URL: /reference
 ✗ Target file not found for: /reference
src/content/blog/2023/03/16/introducing-react-dev.md:610:117
 Link text: Alternatives
 URL: /reference/react-dom/findDOMNode#alternatives
 ✗ Target file not found for: /reference/react-dom/findDOMNode
src/content/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023.md:34:40
 Link text: Next.js App Router
 URL: /learn/start-a-new-react-project#nextjs-app-router
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023.md:95:605
 Link text: Next.js App Router
 URL: /learn/start-a-new-react-project#nextjs-app-router
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2024/02/15/react-labs-what-we-have-been-working-on-february-2024.md:110:3
 Link text: Sathya Gunasekaran
 URL: /community/team#sathya-gunasekaran
 ✗ Contributor link should be updated to: https://github.com/gsathya
src/content/blog/2024/04/25/react-19-upgrade-guide.md:132:20
 Link text: improved how errors are handled
 URL: /blog/2024/04/25/react-19#error-handling
 ✗ Target file not found for: /blog/2024/04/25/react-19
src/content/blog/2024/04/25/react-19-upgrade-guide.md:502:19
 Link text: `ref` as a prop
 URL: /blog/2024/04/25/react-19#ref-as-a-prop
 ✗ Target file not found for: /blog/2024/04/25/react-19
src/content/blog/2024/12/05/react-19.md:358:391
 Link text: Full-stack React Architecture
 URL: /learn/start-a-new-react-project#which-features-make-up-the-react-teams-full-stack-architecture-vision
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2024/12/05/react-19.md:392:28
 Link text: React Server Actions
 URL: /reference/rsc/server-actions
 ✗ Target file not found for: /reference/rsc/server-actions
src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md:2498:37
 Link text: view transition classes
 URL: /reference/react/ViewTransition#view-transition-classes
 ✗ Anchor #view-transition-classes not found in reference/react/ViewTransition.md
Found 58 dead links out of 1555 total links
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
```
* [be] Add deadlinks script
While rewriting the compiler docs I happened to notice some deadlinks. This PR adds a new `yarn deadlinks` script to identify all deadlinks.
I decided to make this a script for now for simplicity but in the future could be ported to an ESlint rule.
The script handles:
- [x] checks images correctly (images are stored in /public but links can omit the /public)
- [x] looks up React error codes for dynamic error pages
- [x] lints links to contributors and uses URL from acknowledgements page if the member is no longer active on the core team
- [x] special injected anchor tags like #recap and #challenges
Example:
```
yarn run v1.22.22
$ node scripts/deadLinkChecker.js
Checking 177 markdown files...
Fetched 552 React error codes
src/content/learn/add-react-to-an-existing-project.md:23:58
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/add-react-to-an-existing-project.md:27:45
 Link text: benefit from the best practices
 URL: /learn/start-a-new-react-project#can-i-use-react-without-a-framework
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/add-react-to-an-existing-project.md:152:269
 Link text: a React framework
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/synchronizing-with-effects.md:735:18
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/typescript.md:16:3
 Link text: Common types from `@types/react`
 URL: /learn/typescript/#useful-types
 ✗ Target file not found for: /learn/typescript/
src/content/learn/typescript.md:17:3
 Link text: Further learning locations
 URL: /learn/typescript/#further-learning
 ✗ Target file not found for: /learn/typescript/
src/content/learn/typescript.md:23:5
 Link text: production-grade React frameworks
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/you-might-not-need-an-effect.md:29:399
 Link text: frameworks
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/you-might-not-need-an-effect.md:754:106
 Link text: frameworks
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/learn/your-first-component.md:218:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/ViewTransition.md:146:248
 Link text: reveal content
 URL: /link-to-suspense-below
 ✗ Target file not found for: /link-to-suspense-below
src/content/reference/react/captureOwnerStack.md:60:94
 Link text: `errorInfo.componentStack` in `onUncaughtError`
 URL: /reference/react-dom/client/hydrateRoot#show-a-dialog-for-uncaught-errors
 ✗ Anchor #show-a-dialog-for-uncaught-errors not found in reference/react-dom/client/hydrateRoot.md
src/content/reference/react/forwardRef.md:9:65
 Link text: here
 URL: /blog/2024/04/25/react-19#ref-as-a-prop
 ✗ Target file not found for: /blog/2024/04/25/react-19
src/content/reference/react/use.md:315:24
 Link text: Server Component
 URL: /reference/react/components#server-components
 ✗ Anchor #server-components not found in reference/react/components.md
src/content/reference/react/useEffect.md:899:67
 Link text: if you use a framework,
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/useEffect.md:1051:18
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/useEffect.md:1736:92
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react/useInsertionEffect.md:136:65
 Link text: non-blocking update,
 URL: /reference/react/useTransition#marking-a-state-update-as-a-non-blocking-transition
 ✗ Anchor #marking-a-state-update-as-a-non-blocking-transition not found in reference/react/useTransition.md
src/content/reference/react-dom/createPortal.md:53:76
 Link text: key.
 URL: /learn/rendering-lists/#keeping-list-items-in-order-with-key
 ✗ Target file not found for: /learn/rendering-lists/
src/content/reference/react-dom/index.md:24:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/index.md:51:3
 Link text: `unmountComponentAtNode`
 URL: /reference/react-dom/unmountComponentAtNode
 ✗ Target file not found for: /reference/react-dom/unmountComponentAtNode
src/content/reference/react-dom/preinit.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/preinitModule.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/preload.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/preloadModule.md:7:1
 Link text: React-based frameworks
 URL: /learn/start-a-new-react-project
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/directives.md:13:36
 Link text: bundlers compatible with React Server Components
 URL: /learn/start-a-new-react-project#full-stack-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/server-components.md:7:34
 Link text: React Server Components
 URL: /learn/start-a-new-react-project#full-stack-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/server-functions.md:198:28
 Link text: `useActionState`
 URL: /reference/react-dom/hooks/useFormState
 ✗ Target file not found for: /reference/react-dom/hooks/useFormState
src/content/reference/rsc/server-functions.md:222:28
 Link text: `useActionState`
 URL: /reference/react-dom/hooks/useFormState
 ✗ Target file not found for: /reference/react-dom/hooks/useFormState
src/content/reference/rsc/use-client.md:44:77
 Link text: compatible bundlers
 URL: /learn/start-a-new-react-project#full-stack-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/rsc/use-server.md:98:54
 Link text: serializable props
 URL: /reference/rsc/use-client#passing-props-from-server-to-client-components
 ✗ Anchor #passing-props-from-server-to-client-components not found in reference/rsc/use-client.md
src/content/reference/react-dom/client/createRoot.md:212:278
 Link text: using a framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/client/index.md:7:185
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/components/common.md:919:89
 Link text: check out more examples.
 URL: /reference/react/useRef#examples-dom
 ✗ Anchor #examples-dom not found in reference/react/useRef.md
src/content/reference/react-dom/components/form.md:39:23
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/form.md:233:63
 Link text: reference documentation
 URL: /reference/react/hooks/useOptimistic
 ✗ Target file not found for: /reference/react/hooks/useOptimistic
src/content/reference/react-dom/components/input.md:33:24
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/link.md:33:23
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/meta.md:33:23
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/option.md:39:25
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/progress.md:33:27
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/script.md:34:25
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/select.md:39:25
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/style.md:33:24
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/textarea.md:33:27
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/components/title.md:33:24
 Link text: common element props.
 URL: /reference/react-dom/components/common#props
 ✗ Anchor #props not found in reference/react-dom/components/common.md
src/content/reference/react-dom/server/index.md:7:182
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/reference/react-dom/static/index.md:7:146
 Link text: framework
 URL: /learn/start-a-new-react-project#production-grade-react-frameworks
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2023/03/16/introducing-react-dev.md:45:5
 Link text: API Reference
 URL: /reference
 ✗ Target file not found for: /reference
src/content/blog/2023/03/16/introducing-react-dev.md:610:117
 Link text: Alternatives
 URL: /reference/react-dom/findDOMNode#alternatives
 ✗ Target file not found for: /reference/react-dom/findDOMNode
src/content/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023.md:34:40
 Link text: Next.js App Router
 URL: /learn/start-a-new-react-project#nextjs-app-router
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2023/03/22/react-labs-what-we-have-been-working-on-march-2023.md:95:605
 Link text: Next.js App Router
 URL: /learn/start-a-new-react-project#nextjs-app-router
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2024/02/15/react-labs-what-we-have-been-working-on-february-2024.md:110:3
 Link text: Sathya Gunasekaran
 URL: /community/team#sathya-gunasekaran
 ✗ Contributor link should be updated to: https://github.com/gsathya
src/content/blog/2024/04/25/react-19-upgrade-guide.md:132:20
 Link text: improved how errors are handled
 URL: /blog/2024/04/25/react-19#error-handling
 ✗ Target file not found for: /blog/2024/04/25/react-19
src/content/blog/2024/04/25/react-19-upgrade-guide.md:502:19
 Link text: `ref` as a prop
 URL: /blog/2024/04/25/react-19#ref-as-a-prop
 ✗ Target file not found for: /blog/2024/04/25/react-19
src/content/blog/2024/12/05/react-19.md:358:391
 Link text: Full-stack React Architecture
 URL: /learn/start-a-new-react-project#which-features-make-up-the-react-teams-full-stack-architecture-vision
 ✗ Target file not found for: /learn/start-a-new-react-project
src/content/blog/2024/12/05/react-19.md:392:28
 Link text: React Server Actions
 URL: /reference/rsc/server-actions
 ✗ Target file not found for: /reference/rsc/server-actions
src/content/blog/2025/04/23/react-labs-view-transitions-activity-and-more.md:2498:37
 Link text: view transition classes
 URL: /reference/react/ViewTransition#view-transition-classes
 ✗ Anchor #view-transition-classes not found in reference/react/ViewTransition.md
Found 58 dead links out of 1555 total links
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.
```
* Fix deadlinks
Following `yarn deadlinks` as a guide, I fixed the following deadlinks:
| File | Link Text | Current URL | Issue Type | Actual Fix Applied | Status |
|------|-----------|-------------|------------|-------------------|--------|
| `add-react-to-an-existing-project.md:23` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `add-react-to-an-existing-project.md:27` | benefit from the best practices | `/learn/start-a-new-react-project#can-i-use-react-without-a-framework` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `add-react-to-an-existing-project.md:152` | a React framework | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `synchronizing-with-effects.md:735` | framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `typescript.md:16` | Common types from `@types/react` | `/learn/typescript/#useful-types` | Trailing slash | `/learn/typescript#useful-types` | ✅ Fixed |
| `typescript.md:17` | Further learning locations | `/learn/typescript/#further-learning` | Trailing slash | `/learn/typescript#further-learning` | ✅ Fixed |
| `typescript.md:23` | production-grade React frameworks | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `you-might-not-need-an-effect.md:29` | frameworks | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `you-might-not-need-an-effect.md:754` | frameworks | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `your-first-component.md:218` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `ViewTransition.md:146` | reveal content | `/link-to-suspense-below` | Placeholder URL | `/reference/react/Suspense#revealing-content-together-at-once` | ✅ Fixed |
| `captureOwnerStack.md:60` | `errorInfo.componentStack` in `onUncaughtError` | `/reference/react-dom/client/hydrateRoot#show-a-dialog-for-uncaught-errors` | Missing anchor | `/reference/react-dom/client/hydrateRoot#error-logging-in-production` | ✅ Fixed |
| `forwardRef.md:9` | here | `/blog/2024/04/25/react-19#ref-as-a-prop` | Missing file + anchor | `/blog/2024/12/05/react-19#ref-as-a-prop` | ✅ Fixed |
| `use.md:315` | Server Component | `/reference/react/components#server-components` | Missing anchor | `/reference/rsc/server-components` | ✅ Fixed |
| `useEffect.md:899` | if you use a framework, | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `useEffect.md:1051` | framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `useEffect.md:1736` | framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `useInsertionEffect.md:136` | non-blocking update, | `/reference/react/useTransition#marking-a-state-update-as-a-non-blocking-transition` | Wrong anchor | `/reference/react/useTransition#perform-non-blocking-updates-with-actions` | ✅ Fixed |
| `createPortal.md:53` | key. | `/learn/rendering-lists/#keeping-list-items-in-order-with-key` | Trailing slash | `/learn/rendering-lists#keeping-list-items-in-order-with-key` | ✅ Fixed |
| `react-dom/index.md:24` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `react-dom/index.md:51` | `unmountComponentAtNode` | `/reference/react-dom/unmountComponentAtNode` | Missing file | `https://18.react.dev/reference/react-dom/unmountComponentAtNode` | ✅ Fixed |
| `preinit.md:7` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `preinitModule.md:7` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `preload.md:7` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| `preloadModule.md:7` | React-based frameworks | `/learn/start-a-new-react-project` | Missing file | `/learn/creating-a-react-app` | ✅ Fixed |
| 11 component files | common element props. | `/reference/react-dom/components/common#props` | Wrong anchor | `/reference/react-dom/components/common#common-props` | ✅ Fixed |
| `server/index.md:7` | framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `static/index.md:7` | framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file + anchor | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `introducing-react-dev.md:45` | API Reference | `/reference` | Missing index | `/reference/react` | ✅ Fixed |
| `introducing-react-dev.md:610` | Alternatives | `/reference/react-dom/findDOMNode#alternatives` | Missing file | `https://18.react.dev/reference/react-dom/findDOMNode#alternatives` | ✅ Fixed |
| `react-labs-march-2023.md:34` | Next.js App Router | `/learn/start-a-new-react-project#nextjs-app-router` | Missing file + anchor | `/learn/creating-a-react-app#nextjs-app-router` | ✅ Fixed |
| `react-labs-march-2023.md:95` | Next.js App Router | `/learn/start-a-new-react-project#nextjs-app-router` | Missing file + anchor | `/learn/creating-a-react-app#nextjs-app-router` | ✅ Fixed |
| `react-labs-february-2024.md:110` | Sathya Gunasekaran | `/community/team#sathya-gunasekaran` | Contributor link | `https://github.com/gsathya` | ✅ Fixed |
| `react-19-upgrade-guide.md:132` | improved how errors are handled | `/blog/2024/04/25/react-19#error-handling` | Missing file + anchor | `/blog/2024/12/05/react-19#error-handling` | ✅ Fixed |
| `react-19-upgrade-guide.md:502` | `ref` as a prop | `/blog/2024/04/25/react-19#ref-as-a-prop` | Missing file + anchor | `/blog/2024/12/05/react-19#ref-as-a-prop` | ✅ Fixed |
| `react-19.md:358` | Full-stack React Architecture | `/learn/start-a-new-react-project#which-features-make-up-the-react-teams-full-stack-architecture-vision` | Missing file + anchor | `/learn/creating-a-react-app#which-features-make-up-the-react-teams-full-stack-architecture-vision` | ✅ Fixed |
| `react-19.md:392` | React Server Actions | `/reference/rsc/server-actions` | Missing file | `/reference/rsc/server-functions` | ✅ Fixed |
| `view-transitions-activity.md:2498` | view transition classes | `/reference/react/ViewTransition#view-transition-classes` | Missing anchor | `/reference/react/ViewTransition#view-transition-class` | ✅ Fixed |
| `rsc/directives.md:13` | bundlers compatible with React Server Components | `/learn/start-a-new-react-project#full-stack-frameworks` | Missing file | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `rsc/server-components.md:7` | React Server Components | `/learn/start-a-new-react-project#full-stack-frameworks` | Missing file | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `rsc/use-client.md:44` | compatible bundlers | `/learn/start-a-new-react-project#full-stack-frameworks` | Missing file | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `react-dom/client/createRoot.md:212` | using a framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `react-dom/client/index.md:7` | framework | `/learn/start-a-new-react-project#production-grade-react-frameworks` | Missing file | `/learn/creating-a-react-app#full-stack-frameworks` | ✅ Fixed |
| `rsc/server-functions.md:198` | `useActionState` | `/reference/react-dom/hooks/useFormState` | Missing file | `/reference/react/useActionState` | ✅ Fixed |
| `rsc/server-functions.md:222` | `useActionState` | `/reference/react-dom/hooks/useFormState` | Missing file | `/reference/react/useActionState` | ✅ Fixed |
| `rsc/use-server.md:98` | serializable props | `/reference/rsc/use-client#passing-props-from-server-to-client-components` | Missing anchor | `/reference/rsc/use-client#serializable-types` | ✅ Fixed |
| `react-dom/components/common.md:919` | check out more examples. | `/reference/react/useRef#examples-dom` | Missing anchor | `/reference/react/useRef#usage` | ✅ Fixed |
| `react-dom/components/form.md:233` | reference documentation | `/reference/react/hooks/useOptimistic` | Missing file | `/reference/react/useOptimistic` | ✅ Fixed |
```
$ yarn deadlinks
yarn run v1.22.22
$ node scripts/deadLinkChecker.js
Checking 177 markdown files...
Fetched 552 React error codes
✓ All 1552 links are valid!
✨ Done in 1.07s.
```
Original commit changeset: d52b3ec
Revert this so we can just fix the real deadlinks.
* Revert "Fix deadlinks (#7880)"
Original commit changeset: d52b3ec
Revert this so we can just fix the real deadlinks.
* Update deadlinks script to take into account redirects
Also check if a redirect exists before erroring.
Fixes the actual broken links.
```
$ yarn deadlinks
yarn run v1.22.22
$ node scripts/deadLinkChecker.js
Checking 177 markdown files...
Fetched 552 React error codes
Loaded 49 redirects from vercel.json
✓ All 1554 links are valid!
✨ Done in 0.86s.
```
* Fix deadlinks take 2
Fixes the actual broken links.
```
$ yarn deadlinks
yarn run v1.22.22
$ node scripts/deadLinkChecker.js
Checking 177 markdown files...
Fetched 552 React error codes
Loaded 49 redirects from vercel.json
✓ All 1554 links are valid!
✨ Done in 0.86s.
```
* [compiler] Rewrite React Compiler Docs
We've received [feedback](https://bsky.app/profile/danabra.mov/post/3lr46ciujjs2r) that the compiler docs are difficult to understand and not prominent enough that people don't realize the compiler is a serious project and is near stable.
This PR rewrites the whole compiler doc section, giving it its own category as well as a standalone reference page.
Preview: https://react-dev-git-pr7868-fbopensource.vercel.app/ 
When the compiler bails out on code, it leaves it untouched and unoptimized, so it's always safe for the compiler to bailout.
`panicThreshold` in most cases should be kept as `'none'` unless you want to fail the build on these safe bailouts. It's really only useful during dev when you're working on increasing the coverage of the compiler on your codebase.
I think having it shown here is confusing so I'm opting to just remove it for this particular code example.
Previously the intro was pretty barebones. Fleshed it out a bit more to describe why it might be useful to reach for in a large codebase.
* [compiler] Flesh out incremental adoption intro more
Previously the intro was pretty barebones. Fleshed it out a bit more to describe why it might be useful to reach for in a large codebase.
* [compiler] Add note about gating evaluation
Clarify when the gating function is evaluated.
aurorascharff and others added 26 commits July 8, 2026 19:40
* Clarify use vs await
* Refine based on feedback
* Address review comments
Co-authored-by: Tuna <tuna@MacBookPro.station>
...505)
* [Suspense] Add 'What activates a Suspense boundary' section
* [Suspense] Clarify image activation wording (review feedback)
* Define "suspense-enabled-framework"
* Update outdated framework-less data fetching note to reference use()
* fix: clarify Suspense boundary activation and fallback behavior
* Add code example
* update styling
* Cleanup caveat
* add link to blogpost
* Replace notes with link to suspense docs
* Tweak caveat
* Update caveat to clarify streaming behavior during server rendering
* Address feedback
* address feedback
* Clarify documentation on Suspense-enabled frameworks
* Update links and wording
* Improve example
* Clarify heading for Suspense-enabled frameworks section
* Restructure page
* Update to be docs compliant and clarify images
* Address review feedback
* Add more suspense examples
* Add more examples
* Clarify image loading behavior during <ViewTransition> updates in Suspense documentation
* Enhance Suspense documentation with additional details on font and image loading during <ViewTransition> updates
* Update
* Enhance Suspense documentation with examples of stylesheet loading behavior and vanilla DOM comparison
* agent review
* Polish Suspense activation examples
- Move Canary badges into section headings and render them icon-only
 in the table of contents
- Replace the image demo's text fallback with a profile skeleton
- Add a combined example coordinating data, a stylesheet, a font, and
 an image behind one boundary, with a plain DOM comparison
- Match skeleton dimensions to the revealed content
* Make the combined example's data delay consistent between runs
* Tune Suspense demo heights, data delay, and DOM comparison wording
* Make section openers stand alone and restore demo timing
* Shrink image demo portraits so both cards fit without layout shift
* Name the resources in the combined section opener
* State the ViewTransition condition in the combined section opener
* Align combined section opener with sibling sections
* Frame font and image waiting as Suspense behavior gated on ViewTransition
* Match the combined section opener to its sibling sections
* Document the experimental defer prop
* Reduce the combined example's data delay
* tweak
* Add dynamic OG images for docs pages
* Match OG card design to existing static images
* Generate OG images statically at build time
* Clean up orphaned lockfile entry
* Show section label on OG cards and guard pages without a card
* Center title and enlarge section label on OG cards
...Leadership Council, and refresh membership.
Co-authored-by: Sebastian "Sebbie" Silbermann <silbermann.sebastian@gmail.com>
* Resize long og image text
* address feedback
Please accept my changes for React Alicante and CityJS Athens
* Document browser-only rendering
Add the Canary browser API reference, including optional lazy reasons, server bailout reporting, fatal and abort behavior, navigation entries, and onBrowserBailout options for every streaming, resume, and prerender API that supports it.
* Polish browser API docs and add live example
* Document browser with use and Suspense
---------
Co-authored-by: Aurora Scharff <aurora.sofie@gmail.com>
* Clarify browser-only rendering guidance
* Polish browser-only guidance wording
* Use Canary markers in browser guidance
* Present browser as a use resource
* Polish browser usage labels
* Address browser guidance review
* Clarify browser return value is opaque
* Restore alternative wording
* Restore hydration alternative wording
* Focus use introduction on resources
* Note stable browser cleanup
* Pin matching React Canary versions in Sandpack demos
* Use cached Canary build in Sandpack demos
* Improve browser-only rendering example
* Clarify browser-only example action
* Show browser-only fallback on reload
* Add conditional browser query example
* Move browser query hook into its own example file
* Use IndexedDB in conditional browser example
* Clarify conditional browser rendering example
* Polish browser rendering examples
* Bridge conditional browser examples
* Tighten conditional browser example intro
* Use time zone for conditional browser example
* Clarify conditional example transition
* Lead conditional browser docs with time zone example
* Address conditional browser rendering feedback
* update
* Clarify conditional browser control flow
* Clarify conditional data fetching pattern
* Clarify conditional rendering outcomes
* Polish conditional browser examples
* Clarify conditional query rendering
* Align conditional browser guidance
...632)
* Document missing Fizz server rendering options and fix resume references
This adds the `formState`, `importMap`, `onHeaders`, and `maxHeadersLength` options to the `renderToPipeableStream` and `renderToReadableStream` reference pages, documents the object form of `nonce` for separate script and style nonces, and adds `importMap`, `onHeaders`, and `maxHeadersLength` to the `prerender` and `prerenderToNodeStream` pages. All of these options are supported in stable releases but were never documented. The `resumeAndPrerender` entries on the `react-dom/static` index were marked as experimental-only even though they ship in stable releases, so the badge is removed, and the `resumeAndPrerender` intro destructured a `postpone` property that is actually called `postponed`.
The `resumeToPipeableStream` page no longer documents a `signal` option because the Node.js implementation neither types nor reads it, and it now documents the `onAllReady` callback that the implementation does support. The same page referred to `resume` in its intro and Returns section where it meant `resumeToPipeableStream`, and the `react-dom/server` index linked both resume entries to the `renderToPipeableStream` page; they now point at their own pages.
Co-Authored-By: Claude Code (kimi-k3[1m]) <noreply@anthropic.com>
* Document the formState option for hydrateRoot
This adds the `formState` option to the `hydrateRoot` reference. The option carries the form state produced by a Server Function form submission so that `useActionState` with a `permalink` returns the submitted state during hydration instead of the initial state, and it must match the `formState` passed to the server renderer. The option shipped in React 19.0 but was never documented.
---------
Co-authored-by: Claude Code (kimi-k3[1m]) <noreply@anthropic.com>

vercel Bot commented Sep 7, 2026
edited
Loading

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
ru-legacy-reactjs-org Error Error Sep 7, 2026 3:15am UTC

Request Review


for (const fullPath of candidates) {
try {
const content = fs.readFileSync(fullPath, 'utf8');
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

1 more reviewer
@github-advanced-security github-advanced-security[bot] github-advanced-security[bot] left review comments
Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

AltStyle によって変換されたページ (->オリジナル) /