百度关键词策略：产品文档改版后旧文章哪些引用需要更新
📱 Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
🔗 /f8cc0a9c46bd.html
📄
百度关键词策略：产品文档改版后旧文章哪些引用需要更新
先给结论：不是所有提到旧文档的句子都要改，而是先分清“引用的是名称、位置，还是结论”。名称和位置变了，引用必须同步；结论和前提没变，可以保留但最好补一句“对应新版某节”。判断顺序应该是：先看新版是否改变了原句赖以成立的事实，再看旧文章里这句话承担的是导航作用还是论证作用。导航型引用失效代价低，论证型引用失效代价高，后者优先处理。
为什么会出现“全文替换”和“只改链接”两种做法
产品文档改版后，旧文章里的引用通常有两类变化。一类是结构性变化：章节标题改了、页面路径改了、功能入口挪了、术语统一了。另一类是语义性变化：某个参数默认值变了、某个限制条件放宽或收紧、某个流程步骤被合并或拆开。只改链接的做法，默认旧文章里的描述仍然成立，改的只是“去哪里看”。全文替换的做法，默认旧描述已经不可信，需要按新版重写。
两种做法都可能在特定条件下成立。如果改版只动了目录和措辞，语义没变，那么只改链接和术语是低成本且正确的。如果改版动了行为、默认值或适用范围，只改链接就会留下“链接能打开、但说法已经不对”的文章，读者按旧描述操作会得到不同结果。反过来，如果只是章节改名却全文重写，会引入新的不一致，还可能把原本正确的例子改坏。
用三个可观察证据区分该改哪一层
第一个证据是旧文章里那句话有没有“可执行动作”。如果句子是“详见某文档的某章节”，它只是导航，路径和标题变了就更新；如果句子是“把某开关设为关闭，然后保存”，它承载操作，需要对照新版确认默认值和步骤顺序是否仍然一致。第二个证据是这句话是否被后文当作前提。如果后文基于“该功能默认开启”继续推导，那么前提一变，整段论证都要复核，而不只是改一个词。第三个证据是旧文章是否被其他页面引用。被多处引用的旧文章一旦留下过期描述，错误会被复制到更多位置，处理优先级应提高。
一个假设例子：某产品文档把“高级设置”章节改名为“性能选项”，并把超时默认值从 30 秒改为 60 秒。旧文章 A 只写“超时设置见高级设置”，这属于导航引用，改成新章节名即可。旧文章 B 写“默认 30 秒，因此建议把批量任务拆小”，这属于论证引用，默认值一变，后半句建议的成立条件也变了，需要重算或补充“若仍使用 30 秒则……”。这个例子说明，判断依据不是文章新旧，而是引用承担的职能。
实际操作：先标记，再决定改法
可以按下面的顺序处理，每一步的结果都会影响下一步：
- 把旧文章中所有指向该产品文档的引用摘出来，连同它所在的句子一起记录，而不是只记录链接。
- 给每条引用标注类型：导航型、术语型、论证型。标注结果决定后面用哪种改法。
- 导航型和术语型直接替换名称与路径；论证型先对照新版确认事实是否变化。
- 对事实已变的论证型引用，选择重写该句或补注适用条件，并检查同段其他句子是否也依赖旧事实。
- 改完后回看该文章是否还被别的页面引用，若有，同步检查那些页面的转述是否也需要调整。
这里的关键动作是第二步的标注。如果不标注就直接全文替换，容易把只是改了章节名的引用也重写，浪费精力并引入新错误；如果只改链接，论证型引用会留下隐患。标注之后，处理范围自然收窄，下一步该重写还是该补注也就有了依据。
容易误判的几种情况
一种误判是把“链接还能打开”当成“引用仍然正确”。重定向或页面保留都可能让旧链接继续可用，但页面内容已经变化，此时链接可用不能证明描述成立。另一种误判是把“新版没提某功能”直接当成“该功能已删除”。新版没提，可能是移到了别的章节、改成了默认行为，也可能只是文档精简，需要进一步确认，不能仅凭缺失下结论。
还有一种情况是旧文章里引用的是一张截图或一段界面说明。界面元素位置变化通常只影响导航型引用，但如果截图里的默认值或选项状态变了，它就变成论证型引用。判断方法仍然是看这句话是否被用来支撑某个结论，而不是看它是不是图片。
取舍标准与遗留引用清单
可以按代价来决定顺序：论证型引用出错会让读者按错误前提操作，代价高，先改；导航型引用出错只是多一次查找，代价低，可批量处理。如果人力有限，优先处理被其他页面引用最多、且包含可执行步骤的旧文章。对于暂时无法确认的引用，不要强行改成新版说法，可以保留原句并标注适用版本，等确认后再定稿。这样做的结果是：读者不会拿到一个看起来更新、实际未经核实的描述，后续复核也有明确入口。
最后留一份遗留引用清单，记录每条引用的类型、当前处理状态和待确认事项。清单不必复杂，但要能回答“这条为什么还没改”。当新版文档再次调整时，这份清单就是下一次判断哪些引用需要更新的起点，而不是重新通读全部旧文章。
