对程序员来说,技术文章的写作是比较重要的事情,不管是在公司内的总结汇报,还是想增加社区的影响力,都离不开写作能力。
之前总结过一篇写技术文章的心得,叫做《技术文章的核心是什么?谈谈我的思考》,主要讲了技术文章的核心是逻辑清晰。
距离那篇文章有一段时间了,我又踩过一些坑,有了一些新的感悟:
技术文章要在逻辑清晰的基础上,进一步追求文章的易读性和实用性,提升阅读体验(也就是阅读时的爽感),增强文章的吸引力和价值。
而要提升技术文章的阅读爽感,要考虑这么几点:
环环相扣
如果说做到逻辑清晰是技术文章的基础,那环环相扣就是技术文章的进阶了。
环环相扣是指内容不要一下子全讲完,要留下一个信息缺口,引出下一部分内容,直到文章最后再完整闭环。
从标题开始就要留信息缺口,引起好奇心,吸引读者继续往下读,这样完读率会比较高。完读率高了,其他数据才会好。
这方面举一个反面的例子:
这篇是讲 Nest.js 如何做参数验证,并且通过这个案例介绍 Pipe、ExceptionFilter 这两个 Nest.js 的功能。
其实内容还行,有这两个机制的介绍、也有跑通的案例,但数据相较其他文章并不是很好。
后来我思考了一下原因,发现了两个问题:
- 标题直接给闭环了,没有留下信息缺口:
直接在标题里面列出了全部的内容,虽然对文章内容是一个总结,但是没有留下信息缺口,会让人没有点击的欲望。如果换成《 Nest.js 做参数验证的两个底层机制》,应该会更好一点。
- 第一段的内容也是,直接列了会用到哪些技术,给闭环了:
其实列出要讲的点没啥必要,因为这时候列出来读者也不知道它是啥,反而因为知道了后面会讲啥,会失去一些对后面内容的期待。
应该是引出“后端的参数验证”这个话题、激发读者的好奇心就可以了,然后后续内容一点点讲清楚 Nest.js 如何做参数验证。在文章最后闭环,做个完整的总结。
能够做到环环相扣的技术文章是更有吸引力的,因为阅读的过程是满足读者好奇心的过程,体验也会更爽。
交互性
阅读技术文章其实是读者和作者的一个双向的交流,作者讲了一些东西,会引起读者的思考或情绪,之后读者会基于这些思考或情绪继续往下读。
如果在适当的地方抛出一个问题,或者放一个合适的表情包之类的,会有更轻的互动感,阅读体验会更好。
但是,互动不要太多,适当点缀即可,能把内容从逻辑上讲清楚是最重要的。
删繁就简
在保证内容完整性的基础上,内容越简炼越好。
能更简洁明确的表达你的意思,读者阅读起来就会更省力,体验也会更好。没有人喜欢啰里八嗦半天讲不到重点的文章。
标出重点
一篇文章肯定有想重点表达的内容,把它加粗高亮。
作者肯定是更清楚文章的重点是什么,直接标出来,不需要让读者自己去思考总结,这样阅读起来会更省力。而且喜欢速读的读者,也可以快速 get 到文章想表达的内容,满足这部分读者的需求。
实用性
学习技术肯定是为了用,所以技术文章的案例要尽量更有实用价值,而且最好提供完整可跑通的代码。
我前面很多文章都提供了可跑通的案例,并且把代码传到了 github 或完整贴在了文章里。这样读者在理清思路之后,想尝试一下的话,可以直接把代码下下来跑跑。
我写小册和文章都是这样做的:
通过文章读懂思路并不是最终目的,能进一步用起来才是,这样文章的价值会更大一些。
标题要激发好奇心
关于起标题,其实我做的并不好,所以我阅读量忽高忽低的:
这方面我也在学习中