两件看似无关的事,其实在练同一块肌肉。

写代码的人为什么也要写字

两件看似无关的事,其实在练同一块肌肉:把模糊的东西,变成可传递的形状。

代码是压缩

需求是散文,接口是诗歌,测试是脚注。写代码的过程,是不断问 —— 这一行,到底在承诺什么? 承诺写清楚了,bug 会少一半;承诺写模糊了,会议会多一倍。

写作是解压

有些感受不能直接变成函数。它们需要先被叙述 —— 叙述不是浪费,是把潜意识里的乱线,理成别人(或未来的自己)能读得懂的顺序。

同一套纪律

| 写代码 | 写作 | |---|---| | 命名 | 标题 | | 边界 | 段落 | | 重构 | 删改 | | 评审 | 重读 |

好的命名和好的标题,都是克制:一个词承担一个意思,不用三个形容词来壮胆。

我为什么还写

因为交付系统之外,我还需要一块不被 sprint 绑定的地 —— 这里可以慢,可以错,可以留白。写代码让我把世界变清楚;写字让我把自己变清楚。

写作卷示例正文。