大家好,我卡颂。
最近,React新文档终于上线了。从内容上看,新文档包括:
- 理论知识、学习指引
API
介绍
从形式上看,新文档除了传统的文字内容,还包括:
- 在线
Demo
- 示意图
- 小测验
可以说是阅读体验拉满。
但是,由于文档中理论部分内容太详细(比如与useEffect
相关就有5节内容),阅读起来太费时间。且当前官方仅有英文版本,所以对国内开发者不太友好。
恰巧最近GPT-4
发布,将React
新文档投喂给他后,完美解决了上述问题。并且,由于React
新文档讲的实在是太清楚了,以至于学习了文档的GPT
完全能够胜任编程助理的角色。
本文来聊聊GPT-4
与React
文档结合后产生的奇妙体验。
欢迎加入人类高质量前端交流群,带飞
GPT如何学习文档内容
由于GPT-4
的训练数据截止到21年9月,所以他无法提供那之后发布的内容相关的信息。所以,首先我们要给他手动投喂React
文档。
实现起来很简单,只需2步:
- 在需要投喂的文档页打开控制台,执行下述代码:
// 清除所有代码示例,只保留文字内容
document.querySelectorAll('main code').forEach(item => {item.remove()})
// 复制文档文本内容
copy(document.querySelector('main').innerText)
- 将文本内容复制给
GPT
:
如果文档内容太长,可以分段投喂:
至此,我们就得到了熟读React
文档的GPT
。那么,熟读文档的GPT
相比未学习之前都有哪些能力提升呢?
文档大神炼成
得益于Dan(React
新文档作者)编写的逻辑清晰、由浅入深的文档内容,学习过文档的GPT
比学习文档前对React
有了更深的理解。
比如,对于如下代码,在useEffect
的使用上有什么问题么(读者可以先自己试着找找问题):
function List({ items }) {
const [isReverse, setIsReverse] = useState(false);
const [selection, setSelection] = useState(null);
useEffect(() => {
setSelection(null);
}, [items]);
// ...
}
这段代码没有逻辑或语法上的问题。所以,对于未学过新文档的GPT
,虽然他能完全理解这段代码的作用,但并不能发现问题:
React Hooks
发布于19年2月的v16.8
,所以GPT
知道Hooks
如何使用:
在学过新文档后,GPT
可以明确指出例子中使用useEffect
的方式可能会导致的问题:
同时,他还提出了解决办法 —— 在事件回调中直接设置selection
为null
,而不是使用useEffect
。
实际上,这个Demo
出自You Might Not Need an Effect一节,该节讲解了一些常见的useEffect
使用误区。GPT
提供的解决思路正是该节提到的 —— 将useEffect
部分逻辑抽离到事件回调中。
优秀的编程助手
让GPT
学习文档后,还能解锁一个强大能力 —— 私人编程助手。
得益于优秀的文档,GPT
已经掌握React
最佳实践。现在,你可以将业务代码直接投喂给GPT
,让他分析代码有没有不符合最佳实践的地方,并给出修改意见。
比如,对于上述代码,GPT
给出了修改后的代码:
总结
文档体验一直是各大开源项目都在重点发力的地方。以往大家的思路是 —— 提供各种方便开发者理解的工具(比如repl
、在线Demo
、视频文档...)。
随着GPT
的发展,一种体验更好的方式已经出现 —— 提供非常详细的文档,GPT
学习并充分理解文档作者想要传达的思想后,再作为编程助手的角色辅助开发者开发。
比如最近,Astro
团队发布的Houston AI就是投喂了Astro
文档的GPT-3
,Vue
团队也在探索这方面的可能性。
受限于GPT token
费用,这种模式还无法大规模普及。但这完全不妨碍个人开发者根据本文的思路训练自己的编程助手,这无疑是生产力的巨大提升。
当然,一切的前提是 —— 有非常详细、没有纰漏、逻辑自洽的文档。所以,你把微信小程序文档投给GPT
后,他该懵逼还得懵逼......
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。