没有一个统一粒度适合所有项目。决定保留到什么程度,先看一件事:这些文档未来由谁使用、用来做什么。如果只是内部追溯,保留到能还原关键决策即可;如果还要支撑后续改版、交接或对外说明,就需要保留到能独立读懂。粒度太粗,接手的人只能重新问一遍;粒度太细,维护成本会超过它带来的价值。
历史文档通常有三种用途:追溯当时为什么这样定、支撑下一次改动、以及向外部说明交付依据。三种用途对粒度的要求不同。
如果一个项目同时承担三种用途,不要把所有内容塞进同一份文档。按用途分开存放,各自定粒度,比统一加厚更省事。
真正需要重新判断粒度的时刻,往往不是项目结束当天,而是某个前提变了。
原来由同一批人维护时,很多信息靠记忆补足,文档写得粗不影响使用。一旦换成外部人员或新团队,原来的粒度就不够了。此时应把与操作直接相关的部分补到可独立执行的程度,比如环境说明、目录约定、发布步骤。判断标准很简单:让一个没参与过项目的人只看文档,能否完成一次小改动。做不到,就说明粒度不够。
这时不必全量加厚,而应先标记哪些文档仍然有效、哪些只作历史留存。对即将重做的部分,保留决策记录即可;对继续沿用的部分,保留到可操作粒度。把有限精力放在还会被使用的部分,比平均用力更有效。
面对一份旧文档,通常有三种处理方式,各有前提。
判断用哪种方式,可以问一句:如果下一个人照着这份文档操作,会发生什么。会出错,就改写或退出;不会出错但读不懂,就补充;完全够用,就保留。
假设一个项目结束后,只留下一句“首页结构已按确认方案调整”。半年后需要新增一个区块,接手的人无法判断原结构为什么这样排,只能重新讨论一遍,甚至可能改回已经被否定的方案。
如果当时多记两行——改动原因、影响到的页面范围——后续讨论就能直接跳过已经排除的选项。这两行就是粒度差异。它不解决所有问题,但能把“重新问一遍”变成“查一下就知道”。
反过来,如果当时把每一次讨论、每一版草稿都完整保留,半年后接手的人要在大量重复内容里找有效信息,同样费时。所以粒度不是越细越好,而是刚好覆盖下一轮使用所需。
选出最近结束的一个项目,挑出三份最可能被再次使用的文档,分别标注用途:追溯、操作还是对外说明。然后按用途检查一遍,缺什么补什么,多余的移出常用位置。做完这一步,你会得到一份明确的保留清单,下一次项目结束时就可以直接套用这个判断顺序,而不必每次从零讨论粒度问题。这个动作的结果会直接影响后续交接效率:清单越明确,接手方需要回头询问的次数就越少。