产品文档改版后,旧文章里要更新的引用分两类:指向已失效或含义变化的文档页面(链接、截图、版本号、字段名),以及把旧文档当作论据的表述。缺少全站抓取权限时,先做一次“引用面清点”也能决定下一步:只改会误导读者的引用,其余留待有数据时再排优先级。
改版通常带来三种变化,处理方式不同。第一种是路径或锚点变了,内容本身没变;第二种是内容口径变了,比如字段含义、默认值、适用版本调整;第三种是文档被拆并或下线,旧文章引用的整段依据不复存在。只有第一种可以靠替换地址解决,后两种必须回到旧文章正文,看引用是否承担论证作用。
区分依据可以看一句话:删掉这个引用,段落结论是否还成立。若结论依赖旧文档中的定义、参数或操作步骤,就属于需要重写的情形;若引用只是“延伸阅读”,替换或移除即可。
如果改版方提供了变更清单(新增、修改、废弃的页面或章节),按清单反向匹配旧文章,效率最高。具体动作:
这样做的结果是一份“必须改”和“可延后”两份名单。下一步不是立刻全量改稿,而是先处理“必须改”里被其他文章反复引用的那几篇,因为它们的影响面最大。
缺少变更记录时,不要假设“抓不到旧路径就等于已下线”。抓取量或索引量下降也可能来自抓取预算调整、站点改版、临时屏蔽,单凭这个现象不能证明文档已废弃。
可执行的最小动作是抽样验证:从旧文章里挑出引用最集中的若干文档页面,逐个打开确认现状,记录三种结果——可访问且内容一致、可访问但内容已变、不可访问。用这份抽样结果估计需要处理的规模,再决定是否申请更完整的权限。抽样只能说明被抽到的部分,不能推广成全站结论,这是必须写明的限制。
显式链接之外,还有几类引用经常被忽略:
截图和文字描述最容易被漏,因为它们不产生失效链接,检查工具通常发现不了。建议在清点时单独列一栏“非链接引用”,人工过一遍。
假设某产品把“工作区”改名为“项目空间”,旧文档路径不变,但字段名和截图都变了。旧文章 A 只是文末附了文档链接,改链接文字即可;旧文章 B 在操作步骤里写了“在工作区设置中勾选 X”,这句话本身已不准确,必须改正文。若只做链接替换,B 仍然会误导读者。这个例子说明:判断依据是引用是否参与正文表述,而不是链接是否可点开。
改完“必须改”的名单后,回看两个信号:一是同一篇旧文档被多少篇文章引用,二是这些文章是否仍在获得访问。前者决定批量处理的收益,后者决定处理顺序。若两者都缺少数据,就先把改动记录成清单,标注每篇的引用类型和处理状态,等有权限时再补。改动本身不会自动带来收录或排名变化,它解决的是读者按旧文章操作时出错的问题。