没有统一粒度,取决于这份文档未来是否还要承担“追责、交接、复用”中的哪一种功能。如果项目结束后双方不再有交付争议、站点也由同一团队持续维护,保留到能还原关键决策和变更记录即可;如果合同约定验收后仍可能追责,或站点将交给新接手方,粒度就要细到能独立复现某次改动的原因、范围和结果。
粒度不是按“越多越好”来定,而是按读者来定。项目结束后,历史文档通常只有三类读者:
第一类读者只需要结论和关键节点;第二类读者需要可执行的操作路径;第三类读者需要时间、动作、依据三者能对应上。粒度定在哪一档,先看这三类读者里谁最可能真的出现。
如果项目结束后还是同一批人继续做,文档的作用是防止记忆偏差,而不是培训陌生人。这种情况下可以只保留三类内容:
日常小改动、重复性的内容发布记录、临时排查过程,不必逐条留档。判断标准是:三个月后如果没人记得这件事,会不会导致重复劳动或误操作。会,就留;不会,就可以合并成一条阶段小结。
实际动作上,可以把散落的文档合并成一份按时间排序的决策记录,每条只写“改了什么、为什么、影响哪些页面”。合并完成后,下一步是让接手或续做的人试读一遍,读不懂的地方就是粒度不够的地方。
如果项目结束后由另一批人接手,文档粒度必须提高到能独立复现一次改动。此时只写结论不够,因为新团队不知道结论是在什么前提下得出的。需要保留的内容包括:
这里容易出现一个反常现象:文档写得很全,但新团队仍然无法接手。原因通常不是粒度不够,而是记录的是“做了什么”,没有记录“当时排除了什么”。被排除的方案往往决定了后续不能轻易回退,这部分必须单独写清楚。
假设一个场景:项目期间把某类页面的模板做了统一调整,原因是当时业务侧确认这类页面不再单独运营。这个前提如果没写进文档,新团队看到模板统一,可能误以为是技术规范,进而在新业务里继续套用。文档里补一句“此调整依赖业务侧不再单独运营该页面类型,若该前提变化需重新评估”,就能避免这类误判。这是假设例子,不是真实项目记录。
有两种内容容易被过度保留。一是过程性沟通记录,例如每次会议的完整讨论;二是已经被后续改动覆盖的中间版本。前者可以只留结论和待办,后者可以只留最终状态和变更说明。
但要注意例外:如果某次中间版本涉及合同约定的验收项,或者改动本身可能引发争议,那么对应的记录不能只留结论,需要保留时间点和依据。是否属于例外,看它是否可能被第三方拿来判断责任,而不是看它技术上是否重要。
把整理好的文档交给一个没参与项目的人,让他只依据文档回答三个问题:这个站点过去半年改过哪些影响面较大的地方;如果现在要回退其中一项,步骤是什么;有哪些前提一旦变化就需要重新评估。三个问题都能答上来,粒度就够;答不上来的那一项,就是需要补细的部分。
这个动作的结果会直接决定下一步:如果卡在“回退步骤”,说明操作记录不足;如果卡在“前提变化”,说明决策依据没写清;如果三个问题都能答,就不必再为了完整而继续堆文档。保留粒度的终点不是穷尽所有细节,而是让下一个需要用它的人能独立做出判断。