产品文档改版后,旧文章里的引用要分两类处理:指向已删除或已改名的页面,必须立即更新;指向仍然存在但含义已经变化的页面,要先判断读者按旧引用操作会不会出错,再决定改还是留。判断依据不是链接能否打开,而是引用所承诺的内容是否还成立。
把旧文章里的引用分成两种故障。第一种是失效引用:目标页被删除、合并或改了路径,读者点开得到404或跳转到不相关页面。第二种是语义漂移:页面还在,但改版后它讲的东西变了,旧文章引用的那句话已经站不住。
只查失效引用会漏掉更麻烦的一类。假设一篇旧文章写“参数配置见产品文档第三章”,改版后第三章变成了计费说明,链接照样能打开,读者却会按错误预期往下读。这类引用不报错,但会持续误导。
实际操作上,先导出旧文章里所有指向产品文档的链接,逐个打开确认目标页是否还在、标题是否还对得上。对得上标题的,再读一遍旧文章引用它的那句话,确认承诺是否仍然成立。这一步的结果决定后面走哪条路。
这种情况下引用可以保留,但要做一次锚文本校准。改版常伴随页面标题变化,旧锚文本可能还在用已经废弃的叫法。把锚文本改成新文档里的正式名称,读者点进去才不会觉得两边对不上。
动作是:只改锚文本,不改句子结构,也不因为改版就顺手重写整段。结果是旧文章的引用与新文档用词一致,后续维护时更容易比对。如果锚文本里带了版本号、章节号这类会再次变动的内容,考虑去掉具体编号,只保留页面主题名。
这时不能只换链接。要先确认旧文章那段话本身是否还有价值:如果它讲的操作在新文档里已经不存在,删掉整段引用比硬找一个替代页面更诚实;如果操作还在,只是换了位置,就把引用指向新位置,并检查上下文描述的步骤是否还准确。
动作是:对每一条失效或漂移的引用,写下“旧引用承诺什么、新文档对应内容是什么”一句话。两者对不上就删或改写,对得上就换链接。结果是旧文章不再把读者引向错误预期,也避免为了保住链接而保留过时说明。
改版后一次性排查容易越改越多。可以用一张简单对照表限制范围,每行只记四项:旧文章路径、被引用的旧文档页、改版后状态、处理方式。处理方式只允许“保留并校准锚文本”“换链接”“删引用并改写上下文”三种,避免临时起意重写整篇。
完成一轮后,抽查几条改动过的引用,按读者路径实际点一遍,确认从旧文章到新文档的阅读顺序没有断点。如果发现某条引用改完后上下文读起来突兀,说明那段话本身依赖旧文档结构,需要回到句子层面调整,而不是继续换链接。
有两种情况应当保留旧引用不动。一是引用指向的是历史版本说明,读者需要看到当时的行为描述,换成新文档反而丢失语境;二是引用出现在发布日期明确的公告或版本记录里,改动会让记录失真。
还有一种例外是外部引用。如果旧文章被其他站点引用并指向了某个文档页,改自己文章里的链接并不能修正外部指向,这时更实际的做法是在旧文章顶部加一句说明,指向新的文档入口,而不是假装旧链接仍然有效。
改版后的引用维护不是一次性任务。把对照表留下来,下次文档再变动时,先查表里标记为“保留并校准锚文本”的条目,它们是最容易在下一次改版中变成语义漂移的部分。