结论有前提:如果这份文档未来可能用于交接、追责或复现某次改动,就保留到“能独立还原一次决策”的粒度;如果它只服务于已结束的日常执行,保留到“能看懂改了什么、为什么改”即可。粒度不是越细越好,而是取决于你下次打开它时要回答什么问题。
很多团队把历史文档理解成操作日志,结果留下大量“某日调整了标题”的记录,却看不出当时的判断依据。真正有用的粒度是决策级:谁在什么条件下决定改哪一类页面、依据是什么证据、预期影响哪个环节。操作细节如具体字符数、发布时间,只在能帮助复现时才保留。
一个可用的检验方法是:假设接手的人只拿到这份文档,没有原执行者解释,他能否判断“这个改动是否还应该继续沿用”。能,说明粒度够了;不能,说明缺的是判断依据,而不是缺更多操作记录。
多数外包项目结束后,第二档就够用。第一档容易在半年后失去解释力,第三档成本偏高,除非改动本身具有回退风险。
有一种情况会让“保留到能还原决策”这个结论失效:当文档同时承担对外汇报、对内执行和存档三种用途时,粒度会被迫向最细的一方靠拢,结果执行者需要在一堆汇报口径里翻找实际依据。此时问题不在粒度不够,而在用途混杂。
如果你发现接手的人宁愿重新问一遍,也不愿读文档,先别急着补更多内容。更可能是同一份文档里混了不同读者需要的信息。把决策记录和操作明细分开存放,往往比继续加细更有效。
文档被反复翻查,不一定说明粒度不足。也可能是当时没有记录前提条件,导致读者无法判断结论是否仍成立。区分方法很简单:让一个没参与项目的人只读文档,然后回答“这个改动在什么情况下应该停止沿用”。
如果他能答出前提条件,说明粒度基本够,问题可能在检索或命名;如果他只能复述操作步骤,答不出适用边界,那才是粒度问题。这个动作的结果直接决定下一步:前者去改索引和命名,后者去补决策前提。
假设某次外包执行对一批页面做了标题结构调整,结束后要决定留档粒度。可以只留三类信息:改动覆盖的页面范围、当时依据的判断标准、以及停止沿用的条件。具体到某条标题改了几个字,除非未来需要逐条回退,否则不必保留。
这样做的结果是:下次同类需求出现时,接手者能直接判断旧标准是否仍适用,而不用重新推导一遍。下一步动作也随之明确——若判断标准已变化,就更新决策记录;若只是执行细节缺失,则不必回补。
在归档前,指定一个人用十分钟回答上面那个问题:“什么情况下应停止沿用这份文档里的结论。”答得出,就按现有粒度归档并标注前提;答不出,就只补前提和适用边界,不补操作流水。这个动作的成本很低,却能决定这份文档半年后是被打开,还是被跳过。