meta description：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /1067d06b612a.html
📄
meta description：产品文档改版后旧文章哪些引用需要更新
产品文档改版后，旧文章里最该先动的不是正文，而是引用产品文档的链接和描述性摘要。判断依据是：旧文章引用的页面地址、页面标题、功能名称是否已经变化。如果地址变了，链接必须更新；如果地址没变但页面内容变了，摘要需要核对；如果旧文章本身已不再承担引流或说明职责，可以直接退出，不必逐个修补。
先区分三种变化，再决定保留、改写还是退出
产品文档改版通常带来三类变化，它们对应不同的处理动作。
- 地址变化：旧链接指向的页面被合并、拆分或迁移。这类引用必须更新，否则读者点击后落到空页或错误页。处理动作是替换为新地址，并检查新页面标题是否与旧文章语境一致。
- 内容变化但地址未变：同一页面里的功能名称、参数、步骤顺序改了，旧文章的描述可能已经过时。处理动作是核对摘要文字，若摘要里出现旧功能名或旧流程，改写为当前说法；若摘要只做概括，可保留。
- 旧文章职责消失：改版后，旧文章想回答的问题已经由新文档直接覆盖，且旧文章没有独立流量或转化任务。处理动作是退出，设置跳转或标注归档，不再维护。
这三种动作不是按文章数量平均分配。先处理地址变化，因为它是硬错误；再处理内容变化，因为它影响可信度；最后评估退出，因为它涉及取舍。
用可核对的证据区分“需要改”和“看起来需要改”
一个常见反常现象是：改版后旧文章的点击量下降，但页面本身并没有引用错误。这时不能直接断定是摘要过时，因为点击下降还可能来自其他合理解释：搜索结果展示位置变化、竞争页面增加、用户需求季节性波动，或者旧文章在结果页的标题被改写。这些解释与摘要质量无关。
可核对的证据包括：
- 打开旧文章，逐条检查外部引用链接是否可访问，页面标题是否与链接文字一致。
- 对照产品文档当前版本，检查旧文章摘要里出现的功能名、参数名、步骤编号是否仍然存在。
- 查看旧文章自身是否还有明确的读者任务，例如“如何配置某功能”。如果该任务已由新文档承担，旧文章的存在理由需要重新评估。
只有第一项和第二项出现不一致时，才构成更新摘要或链接的直接依据。第三项用于决定是否退出，而不是用于判断摘要对错。
一个假设例子：摘要里保留了旧功能名
假设某产品文档改版后，把“批量导入”改名为“数据导入”，页面地址不变。旧文章摘要写的是“使用批量导入完成初始数据准备”。这时地址可访问，但摘要里的功能名与当前文档不一致。
处理动作是：把摘要里的“批量导入”改为“数据导入”，并确认正文里首次出现该功能时也同步改名。这个动作的结果是，读者从搜索结果进入旧文章后，看到的术语与产品文档一致，不会因为名称不同而怀疑自己找错了页面。下一步是检查同一批旧文章里是否还有相同旧功能名，批量处理，而不是逐篇重新评估。
如果改版只是调整了页面内部排版，功能名和地址都没变，那么摘要可以保留。保留的前提是：摘要仍然准确概括了页面内容，且旧文章本身没有其他过时引用。
退出的适用条件与不适用条件
退出不是“旧文章一律删除”。它适用于以下条件同时成立时：旧文章的主题已被新文档完整覆盖；旧文章没有独立的外部链接或收藏价值；旧文章不再承担引导读者完成某个任务的作用。
不适用于：旧文章仍有外部网站引用，删除后会产生死链；旧文章包含新文档没有的示例或背景说明；旧文章是某个流程的唯一入口。这些情况下，保留并更新引用比退出更合适。
退出的实际动作可以是设置从旧地址到新文档的跳转，或在旧文章顶部标注“此内容已迁移至新文档”并保留可读内容。动作的结果影响下一步：如果跳转后旧地址仍有访问，说明外部引用尚未清理，需要继续更新引用来源；如果访问归零，也不能单独证明退出正确，因为访问归零还可能来自链接被移除、搜索结果不再展示或统计口径变化。
更新顺序与验收依据
建议按以下顺序处理，每步都有可验收的结果：
- 先列出所有旧文章中引用产品文档的链接，标记地址是否可访问。不可访问的链接优先替换。
- 再核对摘要和正文中的功能名、参数名是否与当前文档一致。不一致的改写，一致的保留。
- 最后评估旧文章是否还有独立职责。没有职责且无外部引用的，退出；有职责或仍有引用的，保留并完成前两步。
验收依据不是“更新了多少篇”，而是：随机抽取更新后的旧文章，点击其中引用链接能到达正确页面，摘要中出现的功能名与目标页面一致。如果这两个条件满足，这批引用就算处理完成；如果不满足，回到对应步骤继续修正。
