React要重写文档了

Vue和React，写文谁才是写文更好的选择，这个争论似乎从未停过。写文但在一点上，写文双方粉丝似乎达成了难得的写文一致：

Vue文档比React文档好太多。

React开发者对此的写文解释是：Vue是国人开发的嘛，写出来的写文文档当然更符合中国人看啦。

但从#3308[1]来看，写文似乎全球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的当前版本文档[2]解解馋。

参考资料

[1]#3308: https://github.com/reactjs/reactjs.org/issues/3308[2]基于Hooks的当前版本文档: https://reactwithhooks.netlify.app/ 

很赞哦!（3）