[Suggestion]: Tic-tac-toe tutorial should explicitly explain that mutation causes unreliable re-rendering
還沒有人認領這個 Issue。
- 主要語言
- JavaScript
- 星號
- 11.8k
- 分支
- 7.9k
- 平均合併
- 1 天 11 小時
- 30 天內合併 PR
- 11
描述
Summary
The tutorial's Why immutability is important section doesn't clearly state that mutating state causes unreliable re-rendering behavior.
Page
https://react.dev/learn/tutorial-tic-tac-toe#why-immutability-is-important
Details
While following the tic-tac-toe tutorial, I was confused about why .slice() is necessary. The "Why immutability is important" section talks about time travel features and performance optimizations, but it never explains that mutating the array directly will cause React to not reliably detect the change, meaning the component may not re-render.
It seems as though that is the primary reason the tutorial uses .slice(), but it's not mentioned. I only found this explanation later in the "Updating Objects in State" article. It would be helpful to include this explanation in the tutorial where beginners first encounter the pattern.
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
研究方向
開啟連結的 Tic-tac-toe 教學中「Why immutability is important」的部分,並與所參照的「Updating Objects in State」文章進行比較。更新教學,說明直接變更可能會阻止 React 可靠地偵測變更並重新渲染,然後確認該說明符合現有對 slice()、時間旅行和效能的討論。
由索引模型根據 Issue 內容生成。
評估
- 技術堆疊
- javascript, react
- 領域
- documentation
- Issue 類型
- 文件
- 難度
- 1/5
- 預估耗時
- 1 小時以內
- 活躍度
- 停滯
- 描述清晰度
- 描述清楚
- 新手友好度
- 52/100