Commit Graph

29 Commits

Author SHA1 Message Date
Ricky
a5181c291f Bump Activity docs to canary (#7974)
* correct IconExperimental naming and usage (from #7972)

Co-authored-by: Tuna <198469603+TunaDev0@users.noreply.github.com>

* Bump Activity to Canary in docs

---------

Co-authored-by: Tuna <198469603+TunaDev0@users.noreply.github.com>
2025-09-12 12:47:11 -04:00
lauren
b165e71f4f [compiler] Rewrite React Compiler Docs (#7868)
* 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/
2025-07-21 12:41:10 -04:00
Ricky
358d2be565 [blog + docs] React Labs: View Transitions, Activity, and more (#7772)
* init

* Add new error

* Bunch of updates

* Add addTransitionType

* Add Activity

* Expand on Activity

* Expand more on Activity

* Start on vt examples

* wip

* wip

* wip 2

* bump deploy

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* init

* Add new error

* Bunch of updates

* Add addTransitionType

* Add Activity

* Expand on Activity

* Expand more on Activity

* Start on vt examples

* wip

* wip

* wip 2

* bump deploy

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* Update existing VT examples to use video items

* Suspense animation example

* Add customization example

* typos

* Remove TODOs -- we might still want these but cutting scope

* Address wp feedback

* Fix reorder example

* wip

* wip

* wip

* wip

* fix activity iframe resize

---------

Co-authored-by: Jack Pope <jackpope1@gmail.com>
2025-04-23 11:27:48 -04:00
Jack Pope
9f87530c0e Remove captureOwnerStack canary banner (#7701)
* Remove captureOwnerStack canary banner

* Update nav and site config
2025-03-31 12:36:35 -04:00
Sebastian "Sebbie" Silbermann
dfc4448e0d Reference docs for captureOwnerStack (#7427)
Co-authored-by: Ricky <rickhanlonii@fb.com>
2025-02-13 21:01:52 +01:00
Ricky
4673a050e1 Merge v19 docs to main (#7322)
* Convert "Canary" callouts to "React 19 beta" (#6811)

* Convert "Canary" callouts to "React 19 beta"

* Starting in

* Bump version string

* Bump deploy

* Bump deploy

* Bump deploy

* [19] Remove <NextMajor> callouts (#6844)

* Remove <NextMajor> callouts

* rm if(node)

* Delete removed APIs from 19 docs (#6845)

* Add information about ref handling in strict mode (#6777)

* Add information about DOM ref handling in strict mode

* switch order of ref object / ref callback in strictmode doc

* use 'refs to components' terminology instead of 'DOM refs'

* update references to canary/r19

* Expand usage example and remove badges

---------

Co-authored-by: Rick Hanlon <rickhanlonii@fb.com>

* [19] s/"Server Action"/"Server Function" (#7180)

* [19] s/Server Action/Server Function

* Revert /blog and change redirect

* Add note

* Tweak note

* [v19] Update sandboxes to 19 RC (#7196)

* Update transition docs for React 19 (#6837)

* Add async transitions to React 19 docs

* Updates from feedback

* tweaks

* grammar

* Add startTranstion API

* Apply suggestions from code review

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* Updated

* capitalization

* grammar

---------

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* [19] Add docs for prerender APIs (#7320)

* Add prerender APIs

* fix code blocks

---------

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>
2024-12-05 14:03:22 -05:00
Jack Pope
12fca4c24f Add act documentation (#6901)
* Add act documentation

* Update structure based on feedback

* Add usage examples and async act

---------

Co-authored-by: Rick Hanlon <rickhanlonii@fb.com>
2024-05-28 15:05:05 -04:00
Ricky
3981ffea50 Add versions page and nav version (#6814)
* Add versions page and nav version

* Move version to siteConfig.js

* Fix typo

* Set to 18.3.1, use siteConfig in reference sidebar

* Redirect 18.react.dev to react.dev for now

* Fix stray bullet
2024-04-29 22:01:52 -04:00
Ricky
191852ad46 Add blog posts for React 19 Beta (#6778)
* Blog posts for React 19

* Feedback

* Feedback

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Josh Story <josh.c.story@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Matt Carroll <7158882+mattcarrollcode@users.noreply.github.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Matt Carroll <7158882+mattcarrollcode@users.noreply.github.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Noah Lemen <noah.lemen@gmail.com>

* Update src/content/blog/2024/04/25/react-19.md

* Update src/content/blog/2024/04/25/react-19.md

Co-authored-by: Matt Carroll <7158882+mattcarrollcode@users.noreply.github.com>

* Thanks

* Apply suggestions from code review

Co-authored-by: Matt Carroll <7158882+mattcarrollcode@users.noreply.github.com>
Co-authored-by: Sebastian Silbermann <silbermann.sebastian@gmail.com>

* Feedback

* nit

* Issue link

---------

Co-authored-by: Josh Story <josh.c.story@gmail.com>
Co-authored-by: Noah Lemen <noah.lemen@gmail.com>
Co-authored-by: Matt Carroll <7158882+mattcarrollcode@users.noreply.github.com>
Co-authored-by: Sebastian Silbermann <silbermann.sebastian@gmail.com>
2024-04-25 15:40:09 -04:00
Jan Kassens
4f5501088e Rename useFormState to useActionState (#6776)
* move useFormState api

* add redirect

* use React DOM as the name
2024-04-25 13:59:37 -04:00
Jan Kassens
9fb2f0dd12 Move use to APIs (#6774) 2024-04-24 15:58:09 -04:00
lauren
0dc1b315e5 Add initial Rules of React docs (#6680)
This PR adds a new Rules of React reference section that covers the major rules that help developers author idiomatic React apps.

---------

Co-authored-by: Sathya Gunasekaran <gsathya.ceg@gmail.com>
2024-03-15 09:00:17 -07:00
David McCabe
2372ecf920 Initial docs for DOM static resource loading functions (#6459)
* Initial docs for Float functions: preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule
2024-02-02 12:38:09 -08:00
David McCabe
8ba877204d Initial Float docs for hoistable/semantic elements (#6486)
* Initial Float docs for hoistable/semantic elements
2024-02-02 12:37:48 -08:00
Soichiro Miki
55b9e04da0 Remove "canary: true" from useTransition in Sidebar (#6411) 2023-11-06 14:09:49 -08:00
Brian Johnson
81f15204af Adds Reference Overview Page (#6378)
* Adds landing page for reference section.)

* Updated hyperlinks.

* Fixes Legacy APIs link.

* Removes canary image from heading.
2023-10-30 17:43:07 -04:00
Kathryn Middleton
46b45fb873 Add useOptimistic Hook API reference documentation (#6377)
* Add useOptimistic API reference documentation

* Fix title

* Add working exmaple from form and updadd parameters

* Add updates to useOptimistic

* Add updates to useOptimistic

* Add updates to useOptimistic

---------

Co-authored-by: Matt Carroll <mattca@meta.com>
2023-10-27 11:15:07 -07:00
Matt Carroll
4b333ca000 Add <form> Component reference documentation (#6312)
Co-authored-by: Luna <lunaleaps@gmail.com>
2023-10-26 15:22:37 -07:00
David McCabe
5e40d13bcd Add useFormState reference (#6338)
Add useFormState reference
2023-10-25 10:40:39 -07:00
Kathryn Middleton
63f9470249 Add Error Boundary to useTransition API docs (#6354)
* Add Error Boundary to useTransition docs

* add Error Boundary to useTransition

* Use Canary

* Add Error Boundary to useTransition API docs

* Update src/components/MDX/Sandpack/Preview.tsx

Co-authored-by: Jan Kassens <jan@kassens.net>

* Update src/content/reference/react/useTransition.md

Co-authored-by: Luna <lunaleaps@gmail.com>

* Update src/content/reference/react/useTransition.md

Co-authored-by: Luna <lunaleaps@gmail.com>

* Add Error Boundary to useTransition docs

* add Error Boundary to useTransition

* Use Canary

* Add Error Boundary to useTransition API docs

* Update src/components/MDX/Sandpack/Preview.tsx

Co-authored-by: Jan Kassens <jan@kassens.net>

* Update src/content/reference/react/useTransition.md

Co-authored-by: Luna <lunaleaps@gmail.com>

* Update src/content/reference/react/useTransition.md

Co-authored-by: Luna <lunaleaps@gmail.com>

* Address comments and update usage example

* Address comments and update usage example

* Update src/content/reference/react/useTransition.md

Co-authored-by: Luna <lunaleaps@gmail.com>

---------

Co-authored-by: Jan Kassens <jan@kassens.net>
Co-authored-by: Luna <lunaleaps@gmail.com>
2023-10-24 14:26:01 -07:00
Matt Carroll
90ca701621 Add useFormStatus Hook API reference documentation (#6314)
Co-authored-by: Luna Wei <luwe@fb.com>
2023-10-17 15:33:17 -07:00
Sophie Alpert
f2c45ea17f Add labs icon to experimental APIs (#6346) 2023-10-09 11:57:24 -07:00
Sebastian Markbåge
9aa84b1922 Add Experimental Taint API Docs (#6337)
Co-authored-by: Matt Carroll <mattca@meta.com>
2023-10-06 14:39:04 -07:00
Matt Carroll
742d2bff8f Add use hook API reference page (#6177)
* [WIP] Add use hook API reference page

* [WIP] Update use hook API reference page based on feedback

* [WIP] use hook API ref doc: add browser API example

* [WIP] use hook API ref doc: add context, lib examples

* [WIP] use reference doc - incorporate all current feedback

* [WIP] use reference page fix typos

* use reference doc: address PR feedback from Luna, Sophia,Eli, and Lee

* Apply @harish-sethuraman's typo fixes from code review

Co-authored-by: Strek <ssharishkumar@gmail.com>

* use reference doc typo fixes

* use reference doc: update style to match other react.dev conventions

* minor fixes

* Remove client Promises, use canary labels

* Add use hook section to index, remove RSC section on components page

* Final edits

* Clarify use reference caveats

---------

Co-authored-by: Strek <ssharishkumar@gmail.com>
2023-09-08 10:33:16 -07:00
Luna
7141306c90 Add cache API docs (#6240)
Co-authored-by: Ricky <rickhanlonii@gmail.com>
Co-authored-by: Luna Wei <luwe@fb.com>
Co-authored-by: Ricky Hanlon <rickhanlonii@gmail.com>
2023-09-06 10:50:03 -07:00
Ricky
ae06008d57 Add UI for canary releases (#6173)
* [WIP] Add UI for canary releases

* yellow

* Switch to icon and gray

* Wording, alignment, and rm flex

* Heading alignment
2023-08-10 17:10:58 -04:00
Sophie Alpert
292534e975 Add basic reference pages for use client and server (#5976)
* Add basic reference pages for use client and server

I guess this turned into a bit more of an FAQ but I think it's useful to have this written down in a canonical place.

* Oops, push final tweaks
2023-06-30 11:59:55 -07:00
Dan Abramov
67721a6f05 Reorder sections 2023-03-20 04:09:18 +00:00
Dan Abramov
dd65dcac3b Move beta to top level 2023-03-18 22:35:53 +00:00