先给结论:不要按“旧文章一律重写”处理。产品文档改版后,旧文章里的引用分三类——保留(指向未变的概念或稳定锚点)、改写(指向已移动或改名的页面,但读者意图仍成立)、退出(指向已下线功能或已废弃流程)。判断依据不是链接是否报错,而是旧文章承诺的下一步动作是否还能在改版后的文档里完成。
如果旧文章引用的是“什么是增量索引”这类概念页,而改版只是把该页从“基础”挪到“原理”栏目,那么引用仍然成立。此时要做的是确认三件事:页面标题是否仍能回答旧文章抛出的问题;页内锚点是否还在;旧文章读者从这句话出发,能否在两次点击内到达可执行步骤。
保留不等于不检查。一个实际动作是:把旧文章中所有指向文档的链接导出成清单,逐条打开,记录落点标题与旧文章上下文里的承诺是否一致。结果会分成两堆——一致的可暂不动,不一致的进入改写或退出评估。这一步的价值在于把“感觉要更新”变成可核对的清单,避免把稳定引用也一起改乱。
改版最常见的情况是页面被合并或拆分:原来的“配置指南”拆成“初次配置”和“高级参数”,旧文章却仍指向合并前的总页。这时旧文章里的读者意图通常没变,只是需要把引用指向更精确的那一页。改写时优先保留原句的上下文,只替换落点,不要顺手把整段重写——整段重写会引入新的表述风险,而读者的问题并未改变。
假设一个短例子:旧文章写“完成安装后,参考配置指南设置超时”。改版后配置指南只讲概念,具体参数移到了“超时参数”页。此时把引用改到参数页即可,句子结构不动。若改版后参数页又拆成“服务端超时”和“客户端超时”,则要按旧文章读者所处的场景二选一,而不是两个都放——两个都放会让读者在点击前就要做一次本应由文章完成的判断。
当旧文章引用的功能被移除、流程被替换、或页面明确标注不再维护时,改写只会把读者引向一个仍然答非所问的页面。退出不是删掉整篇旧文章,而是把那段引用替换为对当前状态的说明,或指向新的替代流程,并检查旧文章自身是否还值得保留。
这里有一个容易误判的地方:页面返回 404 并不等于必须退出,页面返回 200 也不等于可以保留。404 可能只是路径调整,对应改写;200 可能是内容已被掏空、只剩导航壳,对应退出。判断依据应落在“读者能否在该页完成旧文章承诺的动作”,而不是状态码本身。
先在一小批旧文章上试跑“保留/改写/退出”的判断,容易得出一个过于乐观的结论:只要按落点标题比对就能分类。但样本放大后会出现例外,典型有三类。
这些例外的共同点是:分类依据从“链接是否可用”上升为“旧文章在改版后的内容体系里是否还有独立位置”。这一步无法靠脚本完成,必须在清单里为每条引用补一列判断理由,供后续复核。
具体做法可以固定为:先导出旧文章引用清单,再为每条记录标注目标页当前状态(概念页、操作页、已废弃)、旧文章承诺的动作、以及该动作在改版后是否仍可完成。根据这三项决定保留、改写或退出,并把决定写回清单。下一次文档再改版时,只需重跑清单,而不必重新全量阅读旧文章。
需要说明的适用条件是:这套方法针对的是产品文档这类有明确操作目标的引用,不适用于纯观点引用或外部来源引用。对于后者,判断标准不同,不能直接照搬这里的保留/改写/退出规则。至于引用数量、更新频率或字数,没有通用阈值,应按清单中未解决条目的比例来决定是否继续投入本轮更新。