发布于 · 2026年7月26日
文档保存的,是组织的记忆
写文档不是因为某个人会忘记,而是因为组织迟早会失去当时的上下文。
一次上线准备中,我们遇到了一个看起来很普通的问题。
不同客户会用不同的代码和描述表达同一个业务概念。为了支持这类差异,我们需要确认系统里是不是已经有相应的数据结构。 真正困难的不是理解需求,而是确认旧设计到底有没有覆盖它。
偏偏最熟悉这部分产品的两位同事都在休假。我们翻了历史工单、数据库和已有文档,还是没有找到足够可靠的证据。基于当时掌握的信息,新增一个字段成了最稳妥的方案。
这并不是一个可以随手完成的小改动。它会改变数据模型,也会占用分析、开发、评审和测试资源。团队已经开始围绕这个方案推进。
几天后,一位同事回来。不到一分钟,答案就清楚了:那个字段本来就存在。 我们随即撤回了新增实现。
没有人做错。根据当时能拿到的信息,这个决定完全合理。 真正的问题是:组织拥有答案,却没有让后来的人顺利找到它。
这件事让我意识到,文档的价值不只是“解释系统”。它更重要的作用,是帮助团队判断眼前到底是一个新问题,还是一个已经有答案、只是暂时找不到的问题。
当现有能力无法被确认时,团队自然会开始创造新的能力。于是,不确定性不仅拖慢决定,还会直接改变决定。
好的文档不需要记录所有细节,但应该给下一位接手的人足够的线索,让他知道答案可能在哪里,也敢于相信自己找到的是正确答案。

