关键字密度，产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /6b024fa7c94e.html
📄
关键字密度，产品文档改版后旧文章哪些引用需要更新
先给结论：需要更新的是那些引用已经失效、含义改变或层级迁移的旧文章，而不是所有出现旧文档名称的地方。判断依据不是旧文章里出现了多少次相关词，而是它引用的对象在新版文档中是否还能被读者原样找到。下面用一个假设情境说明如何把分歧变成可核对的清单。
假设情境：一次接口文档改版后的三方分歧
假设某团队把一份接口说明从单页拆成三页，参数表被重命名，旧版页面仍保留但不再维护。此时文档作者认为“旧文章只要还能打开就不用改”，产品经理认为“提到旧接口名字的都要改”，而支持人员反馈用户按旧文章操作后找不到对应字段。三方分歧的根源不是谁更认真，而是各自对“引用有效”的定义不同。
把分歧转成项目的第一步，是给“有效引用”下一个可核对的判定：读者从旧文章出发，能否在两次点击内到达当前维护的对应内容，并且看到与文中描述一致的名称、顺序和默认值。满足则暂不改，不满足则进入更新清单。
先分清三类引用，再决定改不改
旧文章里的引用大致分三类，处理成本差别很大。
- 位置型引用：只提到文档名称或栏目，例如“详见接口说明”。这类引用只要目标页面仍存在，通常只需核对链接是否跳到新位置，不必重写句子。
- 内容型引用：复述了参数名、字段顺序、返回值结构或操作步骤。这类引用最容易失效，因为新版可能改了命名或拆分了表格，旧文章的描述会与当前页面不一致。
- 结论型引用：基于旧版行为给出判断，例如“该参数可省略”。这类引用即使链接有效也可能误导，需要回到当前文档确认行为是否仍成立。
三类里，位置型引用优先批量核对链接，内容型和结论型引用必须逐条比对，不能靠替换同义词解决。
用一次抽样核对决定更新范围
假设旧文章有若干篇，不必一次全改。可以按引用类型各抽几篇，逐篇走一遍“读者路径”：从旧文章点进目标页面，记录三件事——目标是否存在、名称是否一致、描述是否仍成立。这个动作的结果会直接影响下一步：如果位置型引用普遍只是跳转偏移，就先做链接修正；如果内容型引用大量对不上，就要把更新范围扩大到所有复述参数的旧文章，而不是只修被抽到的那几篇。
抽样时要注意，抓取量或点击量下降不能单独证明某篇旧文章需要更新，它也可能是入口调整、季节波动或统计口径变化造成的。反过来，某篇旧文章流量为零也不代表可以忽略，它可能仍被其他文档或工单引用。判断依据应回到引用本身，而不是流量数字。
把清单写成可核对的字段
为了让多个角色对同一事实达成一致，更新清单不要只写“待改”，而应包含可以逐项验证的字段：
- 旧文章标识与所在位置；
- 引用类型（位置型、内容型、结论型）；
- 引用指向的新版目标；
- 需要核对的具体事实，例如参数名、默认值、步骤顺序；
- 核对结果与处理动作，例如改链接、改描述、加注说明或标记为无需处理。
这样，文档作者、产品经理和支持人员可以针对同一行记录讨论，而不是各自凭印象争论。若某条引用暂时无法确认，就把它标为待核对并写明缺少的证据，而不是默认通过。
更新之后要回看什么
完成一轮更新后，重点不是统计改了多少处，而是确认读者路径是否闭合：从旧文章出发能否到达当前维护的内容，且看到的事实与文中一致。可以再抽一次同类引用，检查是否还有跳转偏移或描述过时。若发现某类引用反复出问题，说明改版时的重命名或拆分方式对旧文章不够友好，下一步应考虑在旧页面加简短指向说明，而不是继续逐篇修补。
整个过程中，关键字密度本身不是判断标准：旧文章里相关词出现得多或少，都不能说明引用是否有效，真正需要核对的是引用对象在新版文档中的名称、位置和含义是否仍然成立。把这一点固定成清单字段，分歧就能转成可以逐项验证的项目。
