react.dev

react.dev copied to clipboard

[Suggestion]: Documentation states mutation is "not recommended" when it fundamentally doesn't work, misleading beginners about how React state functions

1

### Summary The React documentation states that mutating state is "not recommended" and that developers can "get away with it," when in fact mutating state doesn't trigger re-renders at all....

sam77777777777

Docs: clarify state mutation and add example

3

Explain why directly mutating objects in state is bad and add a short code example showing immutable updates. Fixes readability for beginners.

punith82

Clarify React’s definition of purity

2

I have some questions about purity in React that I couldn’t find answers to in the docs. It would be helpful if the docs clarified these points and/or someone answered...

gmoniava

refactor: remove debug console logs and improve TypeScript type safety

1

This PR improves code quality by removing unnecessary debug logging and enhancing TypeScript type safety in the codebase. Changes - Remove build-time console.log statements from compileMDX.ts that were logging cache...

ShubhamPatra

[preview: useEffect reference docs ](https://react-5wbg1cutd-fbopensource.vercel.app/reference/react/useEffect#parameters) I had two instances recently where people were confused by useEffect not running after each render (https://github.com/facebook/react/issues/35221 and https://github.com/facebook/react/issues/34730). I think the docs aren't super...

eps1lon

Clarify "counter example" meaning

3

"Counter example" has a specific meaning. Reworded the language to clarify that it points to the example about counter state variable. 

qawt

docs: fix incorrect startTransition usage in server-functions example

1

Closes #8158 Fix incorrect startTransition usage in docs The example in the Server Functions page calls a server action inside startTransition, but the state updates after the await aren’t wrapped...

DeveloperViraj

https://react.dev/reference/rsc/server-functions#server-functions-with-actions 1. Shouldn't setError and setName need to be wrapped with a new startTransition? 2. It seems meaningless to apply startTransition to await updateName in the document, doesn't it? https://react.dev/reference/react/useTransition#react-doesnt-treat-my-state-update-after-await-as-a-transition

ZJRui

docs: Fix typo and grammar in react-performance-tracks.md

1

WuMingDao

docs: Fix grammar in rules-of-hooks documentation

1

WuMingDao