先给结论:产品文档改版后,旧文章里需要优先更新的不是所有链接,而是那些承担“解释依据”或“操作前提”的引用;纯背景提及、已失效但无替代的引用可以保留并加注说明。判断标准只有一条——读者顺着这个引用走下去,是否还能完成旧文章承诺的那件事。
把旧文章里的引用按作用拆成三类,处理方式完全不同。第一类是前提型引用,读者必须先看懂它才能理解旧文章的步骤,比如“按产品文档中的字段说明填写”。产品文档改版后字段名、顺序或默认值变了,这类引用必须更新,否则旧文章的操作链会断在第一步。
第二类是证据型引用,用来支撑旧文章里的某个判断,比如“该限制以产品文档为准”。如果改版只是换了排版、没改限制本身,引用可以保留,但要把锚文本从“点击这里”改成能说明结论的词组,便于读者确认自己没走错。第三类是背景型引用,只是顺带提到某个文档存在,读者不点开也不影响理解,这类可以不动。
实际动作:打开旧文章,逐个引用标记它属于哪一类。只对前提型和证据型建更新任务,背景型统一放到低优先级。这样一轮下来,需要改的数量通常远少于“全部检查一遍”的直觉判断。
如果产品文档改版后旧版本文档被整体下线且没有重定向,那么“背景型引用可以保留”这条就不成立。此时任何指向旧地址的引用都会让读者落到空页,背景型也会变成断链,必须全部替换或删除。
反过来,如果旧版本文档仍然可访问,只是新版并行存在,那么前提型引用也未必都要改成新地址。旧文章描述的是旧流程,强行指向新文档反而会让读者对不上步骤。这时更稳妥的做法是保留旧引用,并在段首补一句“本文对应改版前的流程,新版差异见××”,把选择权交给读者。
所以判断前先确认一件事:旧文档是下线、并行,还是被重定向。这三种状态对应三套处理方式,混用会导致同一篇旧文章里一半引用指向新、一半指向旧,读者无法判断该信哪个。
不必逐条读完所有旧文章。按引用密度排序,抽三到五篇前提型引用最集中的文章,模拟读者路径走一遍:从旧文章出发,点进引用,看能否找到旧文章提到的那个字段、限制或步骤。假设某篇旧文章写“在设置页开启自动同步”,而改版后该选项移到了账户层级,那么这条引用就属于必须更新——不是因为地址变了,而是因为路径变了。
抽查结果会直接决定下一步范围:如果抽查中前提型引用过半失效,说明这次改版动到了旧文章依赖的核心结构,需要按主题批量排查;如果只有个别失效,按单篇修复即可,不必扩大动作。这个判断依据来自引用是否还能支撑旧文章的承诺,而不是改版本身的规模。
只换链接地址往往不够。旧文章里常见的写法是“详见产品文档”,改版后如果文档结构变了,读者点进去仍需自己找,体验并没有改善。更新时把锚文本改成指向具体结论的词组,例如把“详见产品文档”改为“字段默认值的说明”,读者一眼能判断这个引用是否正是自己要找的。
上下文也要跟着调。如果旧文章写“目前支持三种方式”,而改版后文档里变成两种,那么引用更新之外,旧文章里的数字和列举同样要改。只改链接不改正文,会造成引用正确、正文过时的矛盾,读者反而更困惑。这一步的动作是:每更新一个前提型引用,回读它所在的整段,确认段落里的数量、名称和顺序与引用目标一致。
更新完成后,在旧文章里保留一条简短说明,写清本文对应哪个版本的流程,以及引用最近一次核对的时间。这不是为了形式,而是让下一次改版时能快速判断哪些文章需要重新检查。记录里只需包含版本标识和核对范围,不必写成长篇修订日志。
如果旧文章数量多,可以按主题分组记录,例如“账户设置类旧文章统一对应改版前文档”。这样下次产品文档再变动时,能先定位受影响的主题组,而不是重新全站排查。整个流程的重点始终是:先确认旧文档的存续状态,再按引用作用分类处理,最后用抽查结果决定修复范围,而不是一有改版就全量替换链接。