结论先说:保留粒度不按“文件多少”定,而按“下一次需要还原某个决定时,能不能不靠人回忆”来定。项目结束后的历史文档至少要能支撑三类动作——解释一个页面为什么这样写、找到一次改动的批准依据、在换人接手时重建交付边界。达不到这三件事的粒度就是过细,做不到的就是过粗。
常见情形是:建站方交付了一个压缩包,里面有首页文案、栏目结构和若干截图;客户方市场人员认为资料齐全,技术接手的人却认为无法继续。双方都没有说谎,分歧来自对“文档”一词的理解不同。
一种解释是粒度问题:交付方按“成果物”组织文档,只保留最终状态;接手方需要“过程证据”,要能看到某一版为什么被替换。另一种解释是责任边界问题:交付方认为上线即结束,后续改动属于新需求;客户方认为同一项目的延续,理应能追溯到当初的约定。
这两种解释指向不同的补救动作。如果是粒度问题,补的是版本记录和变更说明;如果是边界问题,补的是验收清单和变更确认记录。先分清是哪一种,再决定保留什么。
可以拿一个具体页面做核对,而不是泛泛检查文件夹。假设某产品页在项目中期把主标题从功能描述改成场景描述,然后问三个问题:
如果第一个问题能答、后两个答不上,偏向粒度问题——保留了结果,没保留依据。如果三个问题都答不上,但双方对“谁该负责记录”有分歧,偏向边界问题。这个核对不需要工具,用现有文件走一遍即可。
需要提醒的是,文件数量多、目录层级深,并不能证明粒度合适。大量截图和重复导出件往往只是让压缩包变大,真正要查一个决定时仍然找不到。反过来,文件很少但每个关键改动都有一条说明,也可能已经够用。
把历史文档分成三层,比按文件类型分类更实用。
三层里,决策层最容易被省略,也最影响后续判断。结构层和素材层可以按实际使用频率收缩。
项目结束前,让接手方在不询问原项目成员的前提下,尝试完成一次小改动,例如修改某个页面的联系方式区块。记录他卡在哪一步:
卡点位置直接决定下一步补什么。这个动作的价值在于把“资料够不够”的争论,变成一次可观察的操作结果。假设这次尝试中接手方顺利完成了改动,但事后发现改错了页面,那问题不在文档缺失,而在页面命名或结构说明有歧义,需要补的是标识规则,而不是更多文件。
粒度确定后,再谈保留多久。可以按“是否仍会影响线上内容”来判断:仍在上线的页面,其决策记录和结构说明继续保留;已经下线且不再恢复的栏目,保留一份归档说明即可,不必保留全部中间版本。
清理时不要只按时间删除。更稳妥的做法是先确认三件事:没有未完成的改动依赖这批文件、没有正在进行的争议需要它作为依据、接手方已确认现有文档能独立支撑日常维护。三条都满足,再收缩素材层。
最终要留下的不是最全的一套文件,而是一套能让下一个人独立做出正确判断的最小集合。判断标准始终是同一个:不靠回忆,也能还原决定。