没有统一粒度,判断标准是“未来谁在什么场景下会重新打开它”。如果文档只服务于已经交付并验收的版本,保留到能重建关键决策即可;如果站点还要持续改版、交接或排查线上问题,则要保留到能复现配置与数据结构。实际做法是先按用途分层,再决定哪些原文归档、哪些摘要保留、哪些直接退出。
项目结束后常见的文档大致分三类。第一类是决策类,比如需求确认、变更记录、验收结论,它们解释“为什么做成这样”。第二类是操作类,比如部署步骤、环境变量说明、第三方服务配置,它们支撑“怎么再跑起来”。第三类是过程类,比如会议纪要、中间稿、聊天记录,它们只对当时协作有意义。
粒度取舍主要发生在后两类。决策类通常保留原文,因为改写会丢掉当时的前提和取舍理由。操作类适合保留可执行版本,但不必保留每一次修改的中间态。过程类多数可以压缩成一条结论,前提是结论里写清时间、影响范围和最终决定。
保留原文适用于站点仍在使用、可能追责或需要审计的场景。例如合同约定的交付物、涉及数据处理方式的说明、上线前的验收记录。这类文档的完整度比可读性更重要,改写反而会削弱它的证明作用。
改写为摘要适用于文档量大、但未来只关心结论的场景。比如几十次小改版的记录,可以合并成一份变更摘要,只保留影响页面结构、接口或数据字段的条目。改写的前提是原始文件仍可查,否则摘要一旦有误就无法回溯。
直接退出适用于已被新版本完全取代、且不含责任信息的材料。比如已经废弃的页面草稿、临时占位文案、被否决的视觉稿。退出的条件是该内容不再影响任何线上行为,也不涉及对外承诺。
一个可操作的判断动作是:假设半年后有人要接手,他能否只靠保留的文档完成一次小改版。如果能,粒度就够了;如果他要反复找人问配置,说明操作类文档保留得太粗。
直觉上,文档越多越安全,但实际常常相反:大量过期文档会让人误以为信息完整,接手者按旧步骤操作反而出错。要区分这两种情况,可以看几组可核对的证据。
如果这几项都指向同一版本,说明文档粒度与站点现状匹配。如果只有部分匹配,优先补齐操作类文档,而不是继续增加过程类材料。
假设某站点上线一年后要做一次表单字段调整。如果历史文档只保留了最终页面截图,接手者需要重新确认字段校验规则、提交流程和通知方式,第一步就变成“找人问”。如果保留了字段说明和接口配置,接手者可以直接判断改动影响范围,下一步是做回归测试而不是重新梳理需求。
反过来,如果保留了全部会议纪要和中间稿,接手者可能花大量时间阅读与本次改动无关的内容。这说明粒度不是越细越好,而是要与“下一次可能发生的动作”对齐。
退出不是删除一切。建议先做一次引用检查:搜索当前项目文件、部署脚本和交接说明中是否还指向该文档。如果仍有引用,先更新引用再退出,否则会把问题从“文档过期”变成“链接失效”。
退出动作的结果应影响下一步:如果退出后没有人再询问该内容,说明它确实不再必要;如果退出后频繁被追问,说明其中某些结论应转为摘要保留。这个反馈比事先设定的保留年限更可靠。
最终要保留到什么粒度,取决于站点是否继续维护、是否涉及交接和追责、以及未来改动的类型。把文档按决策、操作、过程分层,再对每层分别决定保留、改写或退出,比统一规定一个年限更接近实际需要。