结论先行:保留到“能重现一次关键判断”的粒度即可,而不是把过程稿、聊天记录和中间版本全部归档。判断标准是,未来接手的人能否仅凭这份文档,知道当时改了什么、为什么改、依据是什么、结果如何。若一份文档无法回答其中任何一项,它要么需要补一行结论,要么可以直接退出归档。
历史文档的价值不在格式,而在它支撑哪种后续动作。可以先用三个问题把材料分档。
分档之后,常见的误区会暴露出来:很多团队把过程档留得最全,却把决策档写得最薄。结果是文件很多,接手的人仍然不知道当初为什么这么做。
项目结束后如果出现与直觉相反的现象,例如改版后某些页面表现变差、下线内容后整体数据反而波动、调整结构后抓取行为变化,这时不要急着用单一现象下结论。请求量、抓取量或某项统计归零,都可能来自多种合理解释:统计口径变化、采集工具调整、页面被合并、访问路径改变、外部环境波动。文档的作用,是把这些解释区分开。
此时需要保留的粒度是“可对照证据”,至少包括:
假设一个项目在结束后发现某栏目流量下降。若文档只记录了“该栏目已调整”,就无法判断下降是结构调整导致,还是统计口径变化导致。若文档保留了URL映射和生效时间,接手的人就能先核对口径,再决定是否需要回滚或补做内容。这里的动作是补一份对照清单,它的结果是让下一步判断有据可依,而不是凭印象归因。
不是所有历史文档都值得原样保留。可以按以下前提做取舍。
一个可操作的判断是:如果一份文档在未来只能回答“当时做过什么”,却不能回答“为什么这样做、影响谁”,它更适合被改写或退出,而不是原样堆积。
如果时间有限,优先整理一份最小可用档案,而不是全面归档。它至少包含四部分:项目目标与范围、关键变更清单、每项变更的判断依据、遗留问题与未验证假设。每项变更用一两句话写清动作和结果,结果未知就写“未验证”,不要用模糊表述掩盖。
这样做的直接结果是,后续无论是复盘、二次优化还是更换服务方,都能先读结论再决定是否翻原始材料。文档粒度是否合适,最终看它能否减少重复判断,而不是看它保存了多少文件。