关键词词库，产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /95e0f712023f.html
📄
关键词词库，产品文档改版后旧文章哪些引用需要更新
先给结论：不是所有提到旧版产品文档的句子都要改。判断依据是“读者是否会因此做出错误动作”。如果一句引用只影响理解背景、不引导操作，可以保留；如果它指向已改名的功能入口、已变化的参数含义或已调整的流程顺序，就必须更新。更稳妥的做法，是先把词库中与产品文档相关的条目分两类，再决定改哪些、留哪些。
两类引用：只影响理解的，和会误导操作的
旧文章里的引用大致分两种。
第一种是背景性引用。例如“关于这个概念的完整说明，可参见产品文档”。这类句子只把读者引向文档，不承诺文档内部结构，也不复述具体步骤。产品文档改版后，只要文档入口还在，这类引用通常不必逐条改。它们不会让读者按错误步骤操作。
第二种是操作性引用。例如“在产品文档的‘账户设置’页找到‘同步开关’，打开后保存”。一旦改版把“账户设置”改成“连接管理”，或把“同步开关”挪到别处，读者照做就会卡住。这类引用必须更新。
两种处理方式成立的条件不同：背景性引用成立，前提是文档入口稳定、概念没被重新定义；操作性引用成立，前提是界面名称、参数含义、步骤顺序在改版后仍一致。只要有一个不一致，就应改。
用关键词词库把分歧变成可核对的清单
多个角色对“哪些要改”常有不同理解。产品角色关注功能是否改名，编辑关注句子是否通顺，支持角色关注用户会不会照着做错。与其争论，不如把分歧落到词库条目上。
可以这样操作：
- 在词库中筛出与产品文档相关的条目，例如功能名、页面名、参数名、流程名。
- 给每个条目补一个字段，标明它在旧文章中是“仅提及”还是“指导操作”。
- 对“指导操作”的条目，逐条对照新版文档，记录三件事：名称是否变化、位置是否变化、含义是否变化。
- 只要有一项变化，就把该条目关联的旧文章列入待改清单；三项都没变，可暂缓。
这个动作的结果会直接影响下一步：待改清单越短，越适合先集中改高流量、高转化或高支持成本的页面；清单很长时，则应先改那些“用户照着做会失败”的引用，而不是平均用力。
一个假设例子：改名与挪位，处理方式不同
假设某产品文档改版，把“通知设置”改名为“消息偏好”，同时把“每日摘要”开关从该页移到了“订阅管理”。
旧文章 A 写的是：“想减少邮件，可在通知设置里关闭每日摘要。”这里同时涉及改名和挪位，读者按旧路径找不到，属于必须更新。
旧文章 B 写的是：“通知机制的背景可参考产品文档。”这里只做背景引用，不涉及具体路径，只要文档入口仍可到达，可以保留。
旧文章 C 写的是：“每日摘要会汇总前一天的数据。”这句话描述的是功能含义，不是操作路径。如果改版没有改变摘要内容，C 也不必因为改名而改；但如果改版同时调整了汇总周期，C 就要更新。
这个例子的重点是：改名不等于所有句子都要改，挪位也不等于背景引用要改。判断单位应是“这句话是否引导读者做一个具体动作”。
词库条目的更新顺序，决定旧文章的处理顺序
词库不是一次性整理完就结束。产品文档改版后，可以先更新词库中受影响最直接的条目，再让旧文章按条目关联去改。这样做的结果是：同一批旧文章不会因为不同角色各自理解不同而被反复修改。
建议按以下顺序推进：
- 先更新名称类条目，因为改名会连带影响搜索、内链和正文表述。
- 再更新路径类条目，因为路径错误最容易让读者操作失败。
- 最后处理含义类条目，因为含义变化往往需要重写解释，而不只是替换词。
如果词库中某个条目只有旧文章引用、没有新文章使用，也不代表它一定该删。它可能仍被外部页面引用，或仍是用户搜索时使用的旧称。此时可以保留条目，但标注“仅历史引用”，避免下次改版时又被当成现行名称使用。
例外：三种情况不必急着改
有三种情况可以暂缓更新，但需要注明理由。
第一，旧文章本身已标记为历史版本，且页面顶部已说明不再维护。此时强行同步所有引用，收益有限。
第二，引用只出现在示例、截图说明或注释中，且不影响读者完成当前任务。可以先记录，等该页下次因其他原因修改时一并处理。
第三，词库条目对应的旧称仍被大量外部内容使用，直接改掉会让新旧说法割裂。此时更合适的动作是保留旧称作别名，并在正文中首次出现时说明新旧对应关系。
这些例外的共同前提是：读者不会因为保留旧引用而做出错误操作。如果会，就不属于例外。
把词库当作核对分歧的清单，而不是当作替换词的仓库，产品文档改版后的旧文章更新就会从“感觉都要改”变成“按影响范围决定先改哪些”。
