没有一个固定粒度适合所有项目,但可以用一条分界线来判断:这份文档以后是否会被用来做出新的决定。会被用来改版、排查故障、迁移服务器或追责的,保留到可执行粒度;只能证明“当时讨论过”的,压缩到结论粒度即可。下面以你手里的一份资料为例,逐步给出可落地的处理方式。
项目结束后,交付物通常混在一起。把它们先分成三类,粒度要求完全不同。
判断一份资料属于哪类,问一句:如果明天要改这个网站,我会不会打开它?会,就按可复现粒度留;不会,就压到结论。
假设你手上有一个已经上线的活动页,包含设计稿、前端代码、后台配置和一段沟通记录。可以按下面的顺序处理。
这个动作的结果会直接影响下一步:如果还原测试环境时卡在某个参数上,就说明该参数必须留在可复现类里,而不是压成结论;如果一路顺利,说明其余过程资料可以安全压缩。
常见取舍是“全量归档”和“只留结论”。两者都有成立条件。
全量归档成立的条件:项目仍在争议期、合同要求留存、或者网站后续由不熟悉的人接手。代价是检索成本上升,旧版本混在新版本里,反而容易用错文件。
只留结论成立的条件:网站已稳定运行、没有未结纠纷、接手人就是原班人马。代价是将来要迁移或排查深层问题时,缺少可复现依据,只能重新摸索。
折中做法是按上面三类分别设粒度,而不是整个项目一刀切。对多数中小项目,可复现类保留完整,过程类只留结论,决策类保留原始签署版本,通常够用。
假设一年后要更换服务器。你打开归档,只看到一份写着“已部署完成”的结论,没有配置说明。这时只能重新推断环境,时间成本不可控。反过来,如果归档里有一份注明假设的配置说明,写清依赖版本和启动顺序,迁移就能按步骤执行。这个对比不说明哪种做法绝对正确,只说明粒度要匹配未来可能发生的动作。先列出未来一年最可能发生的三个动作,再倒推需要保留到什么程度。
粒度可以随项目状态调整。建议在项目结束后设一个复查点,例如三个月后,检查一次:这段时间里是否有人真的打开过过程资料。如果没有,就可以把过程类进一步压缩;如果有人反复查阅某一类文件,说明它被低估了,应提升到可复现粒度。保留期限和访问权限也在这里一并确认,避免归档变成无人维护的堆积。
把这三类分开处理,并让一次实际的还原测试来验证粒度,比争论“留多细”更容易得到可执行的结果。