先给结论:不要按“所有旧文章”批量替换引用,而是以改版后的产品文档为基准,逐条判断旧文章里的引用是否仍指向有效内容。判断依据只有三个——被引用的具体信息是否变了、旧文章是否还在承接搜索需求、更新这条引用是否会改变读者的下一步动作。三者都成立才改;只成立前两个,可以先标记待处理;只成立第三个,改引用不如重写段落。
很多人一看到文档改版,就直接去旧文章里搜产品名、功能名和链接。这样做的代价是:改了一堆不影响结论的引用,真正会误导读者的地方反而漏掉。更稳的做法是先给改版做一次分类,再决定旧文章的引用怎么处理。
把改版内容分成四类,处理方式完全不同:
假设你手上有一篇讲配置流程的旧文章,里面引用了文档的三个小节。改版后,其中一个小节改了标题但内容没变,一个小节的操作顺序调整了,一个小节被合并进另一篇文档。按上面的分类,只有后两个需要动,第一个可以留到下次常规维护时再统一处理。
确定基准后,打开一篇旧文章,把里面的引用逐条列出来。每条引用只会有三种状态,处理动作也不同。
如果旧文章已经把关键结论写清楚,引用只是补充出处,那么文档改版后即使链接地址变了,也可以只更新链接,不动正文。条件是:读者不点链接也能完成当前步骤。这类引用优先级最低,可以攒到一批一起改。
如果旧文章写的是“具体操作见文档某节”,而这一节的位置或名称变了,读者就会卡住。这时必须更新引用,而且最好把新入口的直接描述写进旧文章,而不是只换一个链接。动作是:先在文档里定位新位置,再把旧文章那句话改成读者能直接照做的表述。结果是,这篇旧文章不再依赖文档的目录结构,后续改版对它的影响也会变小。
这是最容易被忽略、代价也最大的一类。旧文章引用文档来支撑某个判断,而文档改版后这个判断的前提变了。此时只改引用是无效的,必须回到旧文章的结论句,重新确认它是否还成立。如果不成立,就要重写这一段,而不是换链接。判断方法很简单:把旧文章的结论句单独拿出来,问一句“按改版后的文档,这句话还对不对”。答案是否定的,就属于状态三。
实际操作中会出现两种做法,各有成立条件。
做法A:全量扫描,按引用清单统一更新。适合旧文章数量可控、引用格式统一的情况,比如所有引用都写成固定格式的链接或固定句式。代价是需要先建立一份引用清单,前期投入大,但之后每次改版都能复用这份清单。如果旧文章里引用写法五花八门,全量扫描的成本会高到不划算。
做法B:只改承接搜索需求的旧文章。适合旧文章数量多、维护人力有限的情况。条件是你能判断哪些旧文章还有读者进入。代价是没被选中的旧文章会继续带着过期引用存在,读者一旦进入就会遇到问题。所以这种做法需要配合一个动作:把未处理的旧文章标记出来,避免它们被内部链接或导航继续放大曝光。
两种做法不冲突。常见的选择是:对状态二和状态三的引用用做法A逐条处理,对状态一的引用用做法B延后处理。判断依据不是文章新旧,而是引用是否影响读者的下一步动作。
把上面的判断落成动作,可以按这个顺序走:
这里有一个容易走偏的地方:引用链接返回正常,不等于引用内容仍然成立。链接可访问只能说明页面还在,不能说明被引用的那部分信息没变。反过来,链接失效也不一定意味着必须重写,如果旧文章本身已经写清了结论,换一个可用出处就够了。这两种现象都不能单独作为处理依据,需要回到变更分类和读者动作上判断。
处理完一批引用后,不要只看改了多少条。更有效的确认方式是反向抽查:随机打开几篇未处理的旧文章,假装自己是第一次阅读的读者,看能否在不点任何链接的情况下完成文章承诺的步骤。如果能,说明这篇旧文章对文档的依赖足够低,引用过期的影响有限;如果不能,说明它属于状态二或状态三,应该补进处理清单。
这个抽查动作的结果会直接影响下一步:如果未处理文章里仍有大量必经入口依赖文档,说明全量扫描的优先级要提前;如果大部分文章都能独立完成步骤,说明可以继续按需求承接情况分批处理,不必一次性铺开。把抽查结果记进同一份引用清单,下次改版时就能直接复用,而不是每次从零开始判断。