结论先行:改版后真正需要动的引用只有三类——被删掉的锚点、被改名的文件名或路径、被替换的结论口径。其余引用可以暂时不动。这个判断成立的前提是你手上有新旧两版文档的标题、锚点和结论差异清单;如果你连旧文引用指向哪个版本都分不清,那先做盘点,别急着改。缺少完整数据时,最小动作是抽样抓取旧文章里的链接和引语,逐条对照,而不是全站重写。
地址型引用指向具体位置:锚点、文件路径、章节编号。口径型引用复述内容:某个参数、某个流程步骤、某句结论。两类失效方式完全不同。地址型只要目标还在,哪怕文案换了也不影响跳转;口径型即使链接正常,内容对不上也会误导读者。
因此优先级不是按文章新旧排,而是按失效后果排:
没有后台权限、拿不到访问日志,仍然可以做两件事。第一,用站内搜索或抓取工具列出所有指向产品文档的链接,记录链接文字和落点章节标题。第二,人工打开每个落点,核对是否还能找到被引用的那句话或那个步骤。
这里有个容易误判的地方:如果某个旧链接的抓取量或点击量归零,不能单独证明它已经失效。更常见的合理解释是那篇文章本身流量下降、链接被折叠在页面深处、或者统计口径变了。反过来,点击量正常也不代表引用有效,读者可能点进去发现内容不对就退出。所以判断依据应是“落点是否还对得上”,而不是流量数字。
假设你负责一个帮助中心,改版把“配置步骤”拆成了“安装”和“初始化”两节。旧文章里写“详见配置步骤第 3 段”。改版后该标题不存在了。这时你只需把引用改成新标题,不必重写整段说明——但如果旧文章正文本身复述了那段步骤,就要一并核对步骤是否变化。这个例子说明:地址型修复范围小,口径型修复范围可能更大,两者不要混着估工。
一个反例:如果改版不是拆分或改名,而是把整个产品逻辑换了,比如原来按“功能模块”组织,现在按“用户任务”组织。此时旧文章引用的不只是某个锚点,而是整套分类方式。你会发现几乎所有引用都指向了不再存在的结构,逐条修的成本高于重写受影响的文章。这种情况下,“只修三类引用”的结论不成立,应改为按主题批量重写。
另一个会让结论失效的条件:文档改版同时改变了术语。旧文章用词 A,新文档统一改成词 B。链接能跳转,但读者看到的标题和正文用词对不上,仍会困惑。这属于口径型失效的变体,需要把引用文字一起改,而不只是改链接。
先建一张三列表:旧引用位置、原落点、新落点。只填你能确认的行,确认不了的空着,不要猜。填完后按上面的优先级处理,先修死链和消失锚点。
改完之后,下一步不是全站复查,而是抽查两类页面:引用最集中的那几篇,以及结论被推翻过的那几篇。抽查时重点看引用文字是否和新文档用词一致,而不只是链接能不能打开。如果抽查发现同一类错误反复出现,再考虑批量替换;如果只是零散几处,手工改完即可收尾。这样做的结果是:你把有限精力放在真正会误导读者的引用上,而不是把改版当成一次全站重写。