描述标签作用：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /cc44ad043b90.html
📄
描述标签作用：产品文档改版后旧文章哪些引用需要更新
改版后真正需要优先处理的，不是所有提到旧界面的句子，而是那些会让人按旧步骤操作、或让搜索结果里的摘要继续指向已消失入口的引用。判断依据是引用是否承担“指路”功能：承担指路的必须改，仅作背景说明的可保留。
先分清两类引用：指路型与背景型
旧文章里的引用大致分两种。指路型引用告诉读者“去哪里点、填什么、看哪个字段”，一旦产品文档改版，这类引用会直接导致操作失败。背景型引用只是解释设计思路、历史原因或概念来源，即使旧入口已不存在，读者仍能理解上下文，不会因此卡住。
可以先用一个简单动作区分：把文章里的每个引用单独摘出来，问“读者如果照着这句话做，会不会找不到东西”。会找不到的，归入指路型；不会的，归入背景型。这个动作的结果决定下一步优先级——指路型引用先改，背景型引用可以等正文其他部分稳定后再统一处理。
两种解释：是入口迁移，还是功能下线
发现旧文章引用失效时，常见两种解释。第一种是入口迁移：功能还在，只是换了位置或改了名称，旧路径不再可达。第二种是功能下线：该能力已被合并、替代或移除，旧文章描述的整个操作都不再成立。
两种解释对应的更新范围完全不同。入口迁移通常只需替换路径、按钮名和字段名，正文结构不用动；功能下线则要重写该段落的操作逻辑，甚至把整篇标记为历史说明或引导到新文档。若把下线误判为迁移，读者会按新路径去找一个不存在的功能；若把迁移误判为下线，则会删掉仍然有效的操作说明。
用三个证据区分两种解释
可以借助以下证据判断属于哪一种，而不是凭感觉决定：
- 新文档里是否存在对应能力。如果新文档有同名或近义功能，只是位置变了，倾向迁移；如果新文档完全没有对应描述，倾向下线。
- 旧入口是否返回明确状态。返回重定向或提示“已迁移”，说明是迁移；返回“不存在”且新文档无替代，说明更可能是下线。
- 旧文章下方的读者反馈。若反馈集中在“找不到按钮”，多为迁移；若集中在“这个功能还能用吗”，多为下线。
需要提醒的是，某个旧页面的访问量下降、抓取频次变化或站内搜索词减少，都不能单独证明引用该改还是不该改。这些现象还可能来自季节波动、渠道调整或整体流量变化。把它们当作唯一依据，容易改错方向。
一个注明假设的短例子
假设某产品文档把“账户设置”下的“通知偏好”迁移到了“个人中心—消息设置”，旧文章里有一句“进入账户设置，打开通知偏好”。这里属于迁移，动作是把路径替换为新路径，并保留原句的其余说明。改完后，读者能按新路径完成同一操作，下一步只需检查同段落里是否还有旧字段名。
再假设“通知偏好”整个功能被“消息订阅”取代，旧文章里的操作步骤已无对应入口。这时属于下线，动作是把该段改为说明新旧关系，并指向新文档中的“消息订阅”，而不是只替换一个路径。改完后，下一步是检查全站是否还有其他文章引用同一旧功能，避免只改一篇留下不一致。
更新顺序与保留边界
实际操作时，可以按引用对读者的影响排序：先改会导致操作失败的指路型引用，再改影响理解的术语，最后处理纯背景引用。对于确实属于历史说明的旧文章，可以保留旧引用，但要在开头或相关段落标明适用版本，让读者知道这不是当前操作路径。
判断是否保留的一个实用标准是：这句话删掉后，读者是否还能完成本文要解决的任务。能完成，就可以保留；不能完成，就必须更新。按这个标准逐条过一遍，比整篇重写更省力，也更不容易漏掉真正影响使用的引用。
