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/
相关文章
- 金融服务领域的大数据:即时分析
- 影响大数据、机器学习和人工智能未来发展的8个因素
- 从0开始构建一个属于你自己的PHP框架
- 如何将Hadoop集成到工作流程中?这6个优秀实践必看
- SEO公司使用大数据优化其模型的5种方法
- 关于Web Workers你需要了解的七件事
- 深入理解HTTPS原理、过程与实践
- 增强分析:数据和分析的未来
- PHP协程实现过程详解
- AI专家:大数据知识图谱——实战经验总结
- 关于PHP的错误机制总结
- 利用数据分析量化协同过滤算法的两大常见难题
- 怎么做大数据工作流调度系统?大厂架构师一语点破!
- 2019大数据处理必备的十大工具,从Linux到架构师必修
- OpenCV中的KMeans算法介绍与应用
- 教大家如果搭建一套phpstorm+wamp+xdebug调试PHP的环境
- CentOS下三种PHP拓展安装方法
- Go语言HTTP Server源码分析
- Go语言HTTP Server源码分析
- 2017年4月编程语言排行榜:Hack首次进入前五十