便宜的项目往往在文档上省成本,但真正影响下次改版的不是文档多少,而是保留粒度是否够用。结论是:保留到“能独立重建一次关键决策”的粒度即可,通常包括最终交付物、变更记录和配置说明三层;再细的过程稿可以清理。这个结论只在项目由同一团队持续维护时成立,一旦更换服务商或多人接手,粒度需要上调。
判断粒度前,先把历史文档按用途分开。三层各有用处,混在一起才会觉得“什么都得留”。
便宜的项目常把三层混在一个压缩包里,导致要么全删、要么全留。全删下次改版找不到依据,全留则每次交接都要重新筛选,反而更慢。
如果满足以下条件,文档粒度可以压到最低:项目由同一人或同一团队继续维护;网站结构简单,页面数量有限;没有复杂的第三方接口或定制逻辑。
此时保留一份最终交付包,加一份按时间排列的变更摘要即可。变更摘要不必写成长文,每条记录说明改动位置和原因就够了。下次改版时,维护者凭自己的记忆加上这份摘要,通常能重建决策链条。
这里的关键不是“文档少就好”,而是维护者本身承载了部分上下文。文档只是补充,不是唯一依据。
假设一个项目由原团队维护两年,文档只留了交付包和变更摘要。某天原团队不再参与,新接手的人打开压缩包,看到一堆文件和零散记录,但不知道哪些文件是当前生效的、哪些改动是实验性的、某个页面为什么用了一种不常见的结构。
这时问题不是文档数量少,而是缺少“决策依据”这一层。新接手的人只能反向推断,推断错了就会在下次改版中改坏原本正常的部分。原本够用的粒度,因为维护者更换而失效。
这个反例说明:粒度是否够用,取决于谁来看。同一份文档,对原维护者够用,对新人可能完全不够。
更稳妥的做法是先评估接手风险,再决定保留到什么程度。可以用下面几个问题快速判断:
风险越高,越需要把“为什么这样改”写清楚,而不只是记录“改了什么”。这部分恰恰是便宜项目最容易省掉的内容,也是下次改版时最花时间重建的部分。
与其争论保留多少,不如做一次测试。找一个没参与过该项目的人,只给他现有的历史文档,让他回答三个问题:当前生效的页面结构是什么、最近一次改动影响了哪些部分、如果要修改某个页面应该动哪些文件。
如果他能在合理时间内答出来,说明粒度够用;如果答不出或答错,说明缺的是决策依据,而不是文档数量。根据测试结果补充缺失的那一层,比盲目多留文件更有效。
这个动作的结果会直接决定下一步:测试通过就按现有粒度归档,测试不通过就补写结构说明和变更依据,再重新测试一次。这样得到的粒度是有依据的,而不是凭感觉定的。