关键词指数：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /53c794cfd135.html
📄
关键词指数：产品文档改版后旧文章哪些引用需要更新
先给结论：改版后要更新的不是所有出现旧产品名的句子，而是那些“引用会改变读者下一步操作”的位置。判断标准只有一条：读者照着这句话去做，会不会因为改版而做错、做漏或找不到入口。会，就必须改；不会，可以留到下一轮。
先分清两种引用：导航型引用与解释型引用
旧文章里的引用大致分两类，处理方式完全不同。
- 导航型引用：告诉读者“去哪里点、填哪个字段、按什么顺序操作”。改版一旦调整了菜单层级、字段名称或按钮位置，这类引用立刻失效，属于高优先级。
- 解释型引用：用旧概念、旧术语说明原理，比如“这个参数相当于旧版的缓存层”。只要原理没变，术语改了也不影响理解，属于低优先级。
实际操作时，可以先做一次快速分类：把旧文章里所有指向产品界面的句子标出来，逐条问“这句话是让人去操作，还是帮人理解”。前者进必改清单，后者进观察清单。
条件一：改版只改了命名和视觉，选择“批量替换术语”
如果这次改版只是把“工作区”改成“项目空间”、把入口从左侧栏挪到顶部栏，功能本身没变，那么批量替换是成立的。代价是：机械替换容易把解释型引用也一起改掉，反而让老读者觉得概念对不上。
更稳的做法是分层替换。先替换导航型引用里的字段名和路径描述，再单独审阅解释型引用，只在会造成歧义时才动。判断歧义的方法很简单：把替换后的句子读一遍，如果读者会问“这跟我知道的那个东西是同一个吗”，就补一句说明，而不是直接换词。
完成替换后，抽三到五篇旧文章，按文章里的步骤实际走一遍。哪一步卡住，说明那一类引用还没改干净，下一步就扩大排查范围到同类文章。
条件二：改版改了流程或数据模型，选择“重写受影响段落”
如果改版合并了步骤、删掉了某个配置项，或者改变了数据之间的关系，批量替换就不够了。这时旧文章的问题不是“名字不对”，而是“路径不存在”。继续保留旧步骤，读者会在中途失败，而且失败点往往在文章后半段，体验更差。
这种情况下要做的动作是：先定位受影响的段落，再决定是重写还是加迁移说明。判断依据是旧流程是否还有过渡期。如果旧入口仍可用，可以在段首加一句“旧版路径仍可访问，但新建项目建议走新版”；如果旧入口已经关闭，就必须重写，不能只加提示。
重写时保留原有的问题描述和结果预期，只替换中间的操作路径。这样老文章仍然能承接原来的搜索意图，读者也不会因为步骤对不上而离开。
一个假设例子：同一篇文章的两种处理
假设某篇旧文章教读者“在设置页开启同步”。改版后设置页拆成了“账户设置”和“项目设置”两个入口。
- 如果同步开关只是换了位置，功能没变：把“设置页”改成具体入口名即可，属于术语替换。
- 如果同步开关被拆成两个独立选项，且默认值变了：必须重写这一段，并说明新旧默认值的差异，否则读者按旧文操作会得到不同结果。
这个例子的意义在于：同样一句“在设置页开启同步”，改版性质不同，处理成本差很多。先判断改版性质，再决定改法，比逐篇通读省力得多。
例外：哪些旧引用可以暂时不动
有三类引用可以放进观察清单，不必在改版当期处理：
- 只出现在文末延伸阅读、不影响主流程的引用。
- 明确标注了版本或时间的引用，读者已经预期它可能过时。
- 指向概念解释而非操作步骤的引用，且术语变化不影响理解。
把它们记下来，等下一次内容盘点时统一处理。这样做的代价是短期内可能有个别读者看到旧说法，但换来的是一次改版不必动全部存量文章。
最后提醒一点：改版后旧文章的点击或展现出现波动，不能单独证明是引用过时导致的。也可能是排序变化、季节因素或抓取延迟。要确认原因，还是回到最初那条标准——读者照着做，会不会做错。
