React要重寫文檔了

React要重寫文檔了

Vue和React，誰纔是更好的選擇，這個爭論彷佛從未停過。但在一點上，雙方粉絲彷佛達成了可貴的一致：

Vue文檔比React文檔好太多。

React開發者對此的解釋是：Vue是國人開發的嘛，寫出來的文檔固然更符合中國人看啦。

但從#3308來看，彷佛全球React開發者都苦文檔久矣。以致於在這個issue中，React Core Team成員rachelnabors痛哭流涕的說：

「爲了彌補官方文檔的不足，熱心的開發者們自制了不少React教程。咱們多麼但願從你編寫第一個React組件開始，直至你職業生涯的終結，官方文檔都是惟一那個陪在你身邊的‘他’啊」。

隨着Hooks承認度愈來愈高，可現有文檔是圍繞ClassComponent展開的，Hooks只是一個獨立章節。

基於這些緣由，React團隊決定重寫文檔。

React文檔難懂的本質緣由

文檔之間的差別真的僅僅由於「中國人編寫的文檔更適合中國人看」？顯然不是。

要理解文檔的差別，須要先談框架的差別。

Vue基於「模版語言」開發，抽象程度更高。本質上他的文檔就是介紹「模版語言」的語法。

那麼就把須要的語法背下來就好了。

而React抽象程度更低，直接使用JS（JSX僅僅是語法糖）。

相比於Vue語法靠背就行，React須要花大篇幅講解各類數據流、設計模式如何在React中使用。

君不見爲了解決組件複用，React有HOC、render props、組合模式等衆多概念。

這一下就難了。

新文檔有哪些改動

知道問題的癥結，讓咱們看看新文檔會有哪些改動。

1. 以Hooks的使用貫穿整個文檔

再也不以ClassComponent舉例，這也代表Hooks成爲事實上的開發標準已經得到社區的承認。

2. 爲編程小白準備的「術語、概念解釋」。

React，包括Redux很喜歡（修改下，是很是喜歡）用各類理論、概念指導工做（好比代數效應之於Hooks）。

這讓不少前端一邊驚歎「高大上」一邊哀嚎「看不懂」。

爲此，新的文檔會增長不少術語、概念的解釋。

3. 更多的示例圖，在線demo，集成Dev-tools和lint。

圖文並茂方便理解，在線demo方便邊學邊練。左右開弓，用心良苦。

而且，此次新文檔由蛋總（Dan Abramov）親自操刀。前端屆頂級網紅出馬，重視程度可見一斑。

何時能看到

這麼香，何時能看到呢？官方給出的答案是：2021年初。

當前版本文檔會歸檔，新版文檔不會在當前版本文檔基礎上修改。

若是等不及了，官方提供了基於Hooks的當前版本文檔解解饞。