结论先行:不是所有提到旧文档的句子都要改,但凡是让读者“照着做”的步骤、参数名、字段含义和跳转路径,都应优先核对;只把旧文档当作背景介绍或延伸阅读的句子,可以暂缓。判断标准不是出现次数,而是这句话失效后读者会不会做错事。若旧文章只是把改版文档列为“参考来源”,且正文已把关键结论讲清,那么不更新通常不会伤害阅读;一旦正文依赖旧文档里的字段名或操作顺序,改版后就会直接误导。
把旧文章里的引用逐条过一遍,可以按功能分成三类:
这个分类的作用是帮你排序,而不是要求一次全改。先动操作依据型,再动定义依据型,最后处理背景装饰型。
面对一批旧文章,常见取舍是“全量替换旧文档链接”还是“只改正文依赖旧文档的段落”。两者都成立,但条件不同。
全量替换适合旧文档已经整体下线、旧地址不再可访问,或者旧文章数量少、替换成本低的情况。代价是容易把只是“延伸阅读”的引用也一起改动,产生一批无实质变化的编辑记录,后续排查改动原因时反而更乱。
只改正文依赖段落适合旧文档仍然可访问、只是结构或字段名调整的情况。代价是旧链接会继续存在,读者仍可能点进旧版页面,因此需要在旧文章里明确写出当前应以哪一版为准。若旧文档已完全不可访问,这种做法就不再成立,必须至少替换掉会让人点空的链接。
假设某产品文档把字段“同步周期”改名为“更新间隔”,取值范围不变,旧文档页面仍可访问。旧文章里有三句话:
按前面的分类,第1句是操作依据型,必须改;第2句是定义依据型,应改;第3句是背景装饰型,可以保留,但最好补一句当前版本以新文档为准。这个例子只用于说明判断顺序,不表示所有改版都只改字段名。
如果旧文章本身已经不再被搜索流量或站内导航触达,那么“先改操作依据型”的排序就没有意义——没有读者到达的页面,改了也无人看到。此时更合理的动作是先决定这些旧文章是保留、合并还是下线,再谈引用更新。反过来,如果旧文章仍在被大量引用,而你只更新了链接却没改正文里的旧字段名,读者点进新文档后仍会按旧字段名操作,问题并没有解决。
具体动作是:把旧文章里所有指向被改版文档的链接和提及句列成一张清单,逐条标注属于操作依据型、定义依据型还是背景装饰型,并记录该旧文章当前是否还有站内入口或外部引用。根据盘点结果,优先修改操作依据型句子,其次修改定义依据型,背景装饰型可批量延后。完成一轮后,再检查旧文章里是否还残留旧字段名、旧步骤编号或旧页面名称——这些残留往往比链接本身更容易让读者做错。若盘点发现某篇旧文章已无入口且内容整体过时,直接下线或合并,比逐句更新引用更省成本。