读《技术写作手册》：把心里明白的事写出来

2024 年 10 月读完这本书时，我记下了一句话：心里明白是一回事，嘴上说出来又是另一回事。

做开发久了，很容易把“代码能跑”当成事情已经完成。可真正到了方案评审、问题复盘，或者要给别人解释一段逻辑时，才会发现自己只是隐约知道，并没有真的把它想清楚。写作恰好会把这些含糊的地方逼出来。一个概念写到一半卡住，通常不是措辞问题，而是理解还没到位。

技术人员平时和机器打交道多，表达能力却不能因此被放到后面。代码需要维护，方案需要沟通，故障也需要让后来的人知道当时发生了什么。很多重复踩过的坑，本来只需要一份清楚的记录。

我现在写博客，也不再只想着“输出一篇像样的文章”。学习也好，工作也好，先留下一点真实的足迹。哪怕当时写得不够好，提笔整理的过程本身，就已经让我比原来更靠近这件事了。