结论先说:保留到“能让下一个接手的人在不联系原班子的前提下,独立完成一次改版、迁移或故障排查”即可。低于这个粒度,文档等于没留;高于这个粒度,维护成本会超过它的实际价值。判断标准不是文档厚不厚,而是它能否支撑一次真实动作。
项目收尾时,历史文档通常有三种去向:原样保留、改写压缩、直接退出。它们不是按重要性排序,而是按“未来还会不会用到”来分。
如果团队缺少完整数据或权限,无法判断某份文档是否还被引用,那就先执行最小动作:把该文档标注为“状态未知,暂不删除”,而不是立刻清空。这个动作的结果是——你保留了追溯可能,同时避免误删仍在生效的配置,下一步才谈得上逐份核实。
与其凭感觉决定留多细,不如看三个信号,它们能区分“该留”和“可退”。
这里要提醒一个常见误判:某份文档长期没人打开,不等于可以删。访问记录归零可能只是因为还没到需要它的场景,也可能是因为权限没开放给需要的人。请求量或打开次数下降,不能单独证明这份文档已经无用,它还有别的合理解释。
假设某项目结束后只留下一句“数据库连接信息见旧邮件”。三个月后需要迁移服务器,接手人找不到那封邮件,只能重新申请权限、重建连接,迁移被迫延后。这是粒度过粗的直接后果。
反过来,如果文档里连每次调试的临时密码、测试账号、废弃接口的完整请求日志都留着,接手人反而要在大量噪音里筛选,判断哪些还有效的时间被拉长。这是粒度过细的代价。
合理的中间状态是:保留最终生效的连接方式、账号归属和权限申请路径,删掉中间调试产生的临时凭据。这样接手人既能直接动手,又不会被过期信息误导。这个例子的数字只是用来说明比较方法,不代表任何真实项目的规模。
如果项目结束后你既没有服务器权限,也拿不到完整的账号清单,不要因此放弃整理。可以做的动作是:
做完这一步,你能得到的结论是“哪些文档还需要进一步核实”,而不能推出“状态未知的文档一定还有用”。这两者的区别,决定了下一步是继续核实还是准备清理。
决定压缩或删除某份文档之前,先确认它没有被其他文档、脚本或流程引用。一个实际动作是:在文档库内搜索该文件名或其中的关键参数名,看是否有其他材料指向它。如果存在引用,就先更新引用方,再处理被引用文档;如果没有引用,再按前述信号决定改写还是退出。
这个动作的结果会直接影响下一步:有引用说明它仍在链条中,不能单独退出;无引用则说明它相对独立,处理风险较低。粒度控制本质上就是不断做这个判断,而不是一次性定死。