关键词聚类：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /74cc9ecb130f.html
📄
关键词聚类：产品文档改版后旧文章哪些引用需要更新
先给判断规则：旧文章里凡是“引用产品事实”的位置，都要按改版后的文档重新核对；凡是“引用外部资料、通用概念、他人观点”的位置，只有在来源本身失效或术语被产品重命名时才动。判断依据不是旧文章发布时间，而是引用内容是否依赖改版中变化的那部分事实。把每处引用标成“产品事实引用”“术语引用”“外部来源引用”三类，再逐条核对，比通读全文更省力，也更容易让不同角色对同一处引用形成一致结论。
先锁定改版中真正变化的事实范围
产品文档改版通常同时发生几件事：页面结构变了、功能名称变了、参数或流程描述变了、部分旧页面下线。这四类变化对旧文章引用的影响完全不同。结构变化只影响你指向的链接地址，不影响正文表述；名称变化会让旧文章里的术语与当前文档不一致；参数或流程变化会让旧文章的说明变成错误信息；页面下线则让引用直接断掉。
实际操作是：拉出改版前后的文档目录，逐项标注“仅路径变化”“名称变化”“内容变化”“已下线”。这份清单是后续所有核对的基准，没有它，不同角色会各自凭记忆判断哪些引用需要改，分歧无法收敛。
把旧文章里的引用拆成可核对的条目
不要以“文章是否过时”为单位判断，而要以“引用条目”为单位。打开一篇旧文章，把每一处指向产品事实的表述单独列出来，通常包括：
- 直接链接到产品文档某页的锚文本和 URL
- 正文里出现的功能名、模块名、按钮名、参数名
- 对操作步骤、默认值、限制条件的描述
- 截图或示例中出现的界面文字
- 指向帮助中心、更新日志、术语表的引用
每列一条，记下它在旧文章中的原话、对应改版前文档的哪一项、改版后该项属于上面四类变化中的哪一类。这一步做完，需要更新的范围就基本确定了，剩下的只是执行顺序。
用三类引用区分“必须改”和“可以不动”
判断一处引用是否需要更新，可以按下面的条件分流：
- 产品事实引用：只要对应事实在改版中属于“名称变化”“内容变化”“已下线”，就必须更新；属于“仅路径变化”，只改链接，不改正文表述。
- 术语引用：如果旧术语在新文档中已被替换，即使旧文章的逻辑仍然成立，也要统一改为新术语，否则读者在文档里找不到对应入口。
- 外部来源引用：产品改版不影响它，除非该来源本身已失效，或它讨论的正是被改版重命名的那个概念。
举个假设例子：某篇旧文章写“在设置页开启自动同步”，而改版后该开关移到“账户偏好”并改名为“跨设备同步”。这条属于名称变化加内容变化，必须同时改术语和路径；如果旧文章只是链接到该设置页，而页面内容未变、仅 URL 变了，则只改链接即可。这个区分能避免把大量只需改链接的文章当成需要重写。
把分歧转成可核对的字段，而不是讨论
多个角色对同一处引用常有不同理解：写作者认为描述仍然准确，产品方认为术语已经变了，SEO 编辑担心改错影响既有表现。把分歧落到字段上就能核对：每条引用记录“旧表述、依据的文档版本、改版后对应项、变化类型、处理动作、处理人”。当两个人对同一条判断不一致时，回到“改版后对应项”这一列，看它属于哪类变化，结论自然收敛。
处理动作也要分级：改链接、改术语、改描述、删引用、整篇重写。分级之后可以按影响面排序，先处理“内容变化”和“已下线”这两类，因为它们会让读者得到错误信息；链接和术语可以批量处理。
更新后如何确认没有引入新的不一致
改完一处引用后，回到改版后的文档确认三件事：链接可达、术语与文档一致、描述与当前行为一致。如果这三项都通过，这条引用就可以关闭；如果发现文档本身对同一事实有两种说法，先不要改旧文章，而是把这个矛盾反馈给文档维护方，等文档统一后再同步。这个顺序很重要，否则旧文章会跟着文档的临时状态反复改动。
最后，把这次核对形成的“变化类型—处理动作”对照关系保留下来。下一次文档改版时，可以直接复用这套分类，先判断变化类型，再决定旧文章里哪些引用需要更新，而不必每次从零讨论。
