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的当前版本文档解解馋。