技术写作很容易被拖到“完全想明白以后”。但真正有价值的经验,常常只存在于问题还没有关闭的时候:为什么这条路走不通,哪个假设刚刚被推翻,下一步准备验证什么。

结论会过期,路径更耐用

库会升级,接口会变化,一段具体结论可能很快失效。但判断依据、取舍过程和失败症状往往能被迁移到下一个问题。把这些内容写下来,是在保存一种可复用的思考方式。

公开构建不是持续展示成果,而是让别人看见一个判断如何被证据慢慢改变。

给不确定性一个清楚的标签

未完成不等于含糊。事实、推测、已验证结论和下一步实验应该被清楚地区分。这样读者能判断哪些内容可以直接采用,哪些只适合作为线索;未来的自己也知道该从哪里继续。

让文章成为工作台

如果一篇文章只能在发布那天成立,它更像公告。如果它能持续容纳新的证据、反例与修订,它才像工作台。写下未完成,不是降低标准,而是把“完成”的定义从给出答案,变成准确呈现当前的理解。