答案不是“把旧文章里的链接全换一遍”,而是先判断旧文章引用的对象是否真的变了。产品文档改版时,最容易被忽略的是:标题没变、链接也没失效,但被引用的那段说明已经换了前提。旧文章如果只检查链接可达性,就会把失效的引用当成有效引用继续用下去。
假设某产品文档把“批量导入”从独立功能页并入了“数据管理”总览页,同时把原来的参数说明改成了分场景描述。旧文章里有一条引用指向数据管理页,链接仍然可访问,于是很多人认为无需处理。但读者点进去后,看到的是总览,不再有旧文章所依赖的那段参数约束。此时链接有效,引用关系却已经断了。
这类问题在小样本里不容易暴露:你抽查两三篇旧文章,恰好都指向未改动的文档,于是得出“改版影响不大”的结论。规模化检查时,例外才会出现——同一批旧文章里,有的引用的是被合并的页面,有的引用的是被拆分的页面,还有的引用的是同一页面里被替换的段落。
第一种解释是“引用对象变了”。如果旧文章依赖的是被合并、被拆分或被改写的那部分文档内容,那么引用需要更新,甚至需要改写旧文章里的表述,而不只是换链接。
第二种解释是“引用对象没变”。如果旧文章只是把文档当作背景资料,读者不需要从文档里获取具体参数或步骤,那么链接可达即可,不必为了改版而批量替换。两种解释的分界,不在链接是否失效,而在旧文章的论证是否依赖被改动的内容。
能区分这两种解释的证据有三类:
如果旧文章只写“详见文档”,而文档改版后不再包含该细节,这就属于需要更新的引用;如果旧文章自己已经把细节讲清,文档只是延伸阅读,那么改版不一定触发更新。
先给旧文章里的每条引用打一个标记:依赖型或参考型。依赖型引用意味着读者必须点进去才能理解旧文章;参考型引用意味着不点进去也不影响理解。这个动作的结果会直接决定下一步:依赖型引用优先核对,参考型引用可以延后。
核对时不要只看链接状态码。打开被引用页面,搜索旧文章里出现过的关键参数或步骤名称。如果搜不到,再判断它是被移到了子页面、被改写成了别的说法,还是被彻底删除。移到子页面的,更新链接即可;被改写的,需要判断旧文章表述是否仍然成立;被删除的,旧文章要么补上替代说明,要么删掉对应引用。
假设某旧文章写“开启该选项后,系统会保留最近三十天记录”,并链接到文档。改版后文档把“三十天”改成了按套餐区分。此时旧文章的引用需要更新,因为读者按旧文章操作会得到不同预期。反过来,如果旧文章只写“该选项用于控制记录保留”,没有给出具体天数,文档改版后这句话仍然成立,引用可以保留。
个别样本成立,不代表可以批量套用。以下边界需要单独判断:
这些边界的共同点是:不能只看“文档改版了”这个事实,而要看旧文章从文档里取走了什么。取走的是结构,影响小;取走的是结论或参数,影响大。
更新引用后,至少做一次反向检查:从被引用文档出发,看还有哪些旧文章指向它,以及这些旧文章是否依赖同一段内容。如果只更新了其中一篇,其他同源引用仍然可能把读者引向旧理解。这个动作的结果会影响下一步:如果同源引用集中,适合按文档维度批量处理;如果分散在不同主题的旧文章里,适合按旧文章维度逐篇判断。
最后,更新记录里不要只写“替换链接”。写清替换原因,例如“原参数已改为按套餐区分,旧文章表述不再成立”。这样下次文档再改版时,才能快速判断哪些旧文章需要重新核对,而不是从零开始猜。