开发者文章无法阅读的最常见原因是内容错误。
在大多数情况下，是因为使用的语言不同。
开发者用技术语言说话，读者用生活语言理解。
如果无法跨越这个鸿沟，即使内容再好，也不会留给人们任何印象。
人们不记得代码
而是记得情境
你可能看过这样的文章。
“这个函数的时间复杂度为O(n)。”
“这个结构具有良好的可扩展性。”
“这种方法更有效率。”
这些说法并没有错。但几天后，几乎没有人记得这篇文章的内容。
相反，这样的句子会留下印象。
“凌晨3点服务器崩溃时，
这段代码能救我吗？”
这句话中没有复杂的技术解释，但有一个情境。
人们通过情境而不是技术来理解，
通过情境而不是技术来记忆。
优秀开发者文章的共同点
仔细观察易读的开发者文章，会发现它们有共同特点。
- 情境先于代码出现
- 背景先于功能描述出现
- 强调选择原因胜于正确答案
换言之，文章流向如下。
情境 → 思考 → 判断 → 选择 → 结果
这种结构更像是故事而不是技术博客。
而故事是
人们最容易接受的形式。
将技术转化为生活语言
将技术转化为生活语言并不意味着要简化难懂的术语。
这是一种视角转变。
举个例子。
- “这个API不符合RESTful标准”
“这个API让初学者
不得不一遍又一遍地查看文档”“这个结构耦合度高”
“这个结构只要改动一个地方，
其他地方也会受到影响”“进行了性能优化”
“即使流量激增，
也能安心入睡”
并非消除技术术语，而是展现了技术带来的‘现实变化’。
为何这种方式更有品牌力
以技术为中心的文章
总是竞争激烈。
总有人
整理得更好，
写得更详细，
解释得更快。
但你经历过的情境是独一无二的。
- 在什么情况下遇到这个问题
- 为什么需要做出这个选择
- 这个选择如何改变了生活
这些只有你能写出来。
因此，将技术文章转化为生活语言，
不易被比较，
不易被取代。
读者感叹“噢，这就是我的故事”时
品牌建设
当人们开始这样说时完成。
“这个人的文章
总是和我的情境契合。”
当这句话出现时，
无论技术多深奥，
人们会持续关注。
因为
这篇文章不是为了提供信息，
而是为了照亮自己。
尝试这样写
在写文章之前，
先思考以下问题。
- 什么时候需要这项技术
- 这个选择是在什么状态下帮助了我
- 引入这项技术前后有何不同
然后以这样的句子开头。
- “当我首次引入这项技术时最担心的是…”
- “决定创建这个功能的那一天…”
- “选择这个结构的原因很简单…”
这样写下去，
技术自然退居次要，
故事占据主导。
下一篇文章
下一篇文章将讨论
如何将这些故事堆叠起来，
在何处，如何堆叠才能塑造品牌。
为什么频繁使用平台不是答案，
为什么需要确定一个‘本源’，
以及为何品牌建设不是
分散的游戏，
而是积累的游戏。
让我们在下一篇文章中继续。