好的技术文章,如何让读者愿意读到最后?
从一个具体问题开始,用清晰的结构承载你的经验,让读者带着收获离开。
从读者遇到的问题开始
与其从工具的历史写起,不如先说明你解决了什么问题。读者能在前几句话里认出自己的困境,就更愿意继续阅读。
给文章一条清晰的路线
一个实用结构是:背景、尝试、结果、局限。它既能展示思考过程,也能帮助读者判断这份经验是否适用于自己的场景。
让示例足够小
代码片段不需要展示整个项目。保留与当前问题有关的部分,并明确省略了什么。每个示例最好只解释一个概念。
说明适用边界
告诉读者哪些结论来自实际测试,哪些仍是假设。诚实的边界比绝对化的表达更有价值。
留下一个可以讨论的问题
文章结束时,可以分享尚未解决的疑问。好的讨论常从这里开始,读者的反馈也可能成为下一篇文章的起点。
14 次阅读
一起聊聊 0
好的讨论,是文章的另一半。
还没有点评,来分享第一个想法吧。