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/
