React全新文檔終于來了
大家好，我卡頌。
React 一直被吐槽官方文檔對新手不友好，而且自從 v16.8 出現 Hooks 后， Hooks 逐漸成為 React 主要發(fā)展方向，新特性都會基于 Hooks 開發(fā)。
但是當前官方文檔還是基于 class component 講解。所以從去年10月開始， React 團隊的 「Rachel Nabors」 開始推進新文檔的編寫。
關于 「Rachel Nabors」 的經歷，可以參考我之前寫的一篇文章 從失學二次元少女到React核心成員
時隔一年，21年10月22日， React新文檔Beta版 [1]終于上線了。
本文會介紹新文檔相比老文檔的不同之處，以及當前進度。
新文檔的特色
一句話概括新老文檔的區(qū)別：
如果說老文檔是論文，那新文檔就是教科書
具體來說，新文檔有三個特點：
1. 所有示例都會用 Hooks 完成
Hooks 是 React 的未來，相比老文檔使用 Class Component 做示例，新文檔全面擁抱 Hooks 。
2. 加入大量交互示例和圖表
光是 從React視角思考 [2]這一節(jié)就包括6段代碼示例、2張圖、3個可交互的示例。
3. 提供習題用來檢驗學習成果
比如， 學習JSX [3]這一節(jié)最后有一道習題，需要你修復錯誤的 JSX 語法：
新文檔主要包括兩部分內容：
- API
新手入門
我們可以從 「新手入門」 的章節(jié)設計體會 React 的用意：
- 安裝
- 用
React的方式思考 - 描述
UI - 增加交互
- 管理狀態(tài)
- 如何繞過
React去手動操作DOM
簡言之就是，通過大量示例、試題循序漸進讓新手學習 React 的基本概念。
「新手入門」 部分當前整體進度為：完成70%
API介紹
「API介紹」 圍繞 Hooks 展開，同樣包含大量示例。當前整體進度為：完成5%
和 class component 相關的老 API 應該不會出現在新文檔中，這部分 API 介紹會被重定向到老文檔中。
總結
不管是 React18 討論組，還是新文檔開發(fā)，都提供了反饋渠道。任何人都可以通過 Github issue #3308 [4]和 匿名論壇 [5]提出意見。
新文檔地址：
https:// beta.reactjs.org/
