先给结论:判断标准不是旧文章里有没有出现旧版术语,而是这条引用是否会让读者做出错误操作。产品文档改版后,需要更新的引用通常集中在三类位置:直接指向已删除或改名的功能入口、仍按旧流程描述操作步骤的链接锚文本、以及引用旧版参数或限制条件的示例。只改名称但操作不变的引用,可以保留;会误导操作的引用,必须改。下面用一个假设情境串起整个判断过程。
假设某产品把后台左侧导航从「数据中心」改名为「数据管理」,同时把「按次计费」改为「按用量计费」,旧版帮助文档中的对应页面被重定向到新页面,但旧文章仍大量引用这两个旧名称。此时旧文章中的引用可以分成四类:
这个分类的目的不是给引用贴标签,而是决定先改哪一批。高风险引用影响读者能否完成操作,应优先处理;低风险引用可以合并到下一次常规内容维护中。
实际动作可以从一次全站检索开始。用旧功能名、旧计费词、旧参数名分别检索站内文章,把命中结果按「是否包含操作步骤」分成两组。只出现在介绍性段落里的命中,记录后放行;出现在编号步骤、截图说明、代码示例中的命中,逐条打开核对。
核对时问三个问题:读者按这条引用操作,会不会点到一个不存在的入口;会不会按已经失效的规则估算成本;会不会因为参数示例报错。只要有一个答案是会,这条引用就进入必改清单。这个动作的结果直接决定下一步:必改清单里的文章需要重写对应段落,而不是只替换词。
旧文章指向旧页面的链接,改版后通常有两种状态:旧页面被重定向到新页面,或者旧页面已删除返回错误页。前者只需要更新锚文本,让读者看到新名称;后者必须换成新页面地址,否则读者会中断。
这里有一个容易忽略的取舍:如果旧页面仍保留重定向,锚文本可以暂时不改,但重定向链会随改版次数增加而变长。假设一次改版新增一层重定向,多次改版后同一链接可能经过三层跳转才到达目标。是否清理取决于你能否接受这种累积,以及是否有工具定期检查跳转层数。能做的是把「锚文本更新」和「重定向清理」排进同一批维护,而不是等链接失效后再补。
保留成立的条件是:引用不涉及操作路径、计费规则或参数限制,且新名称与旧名称指向同一功能。例如旧文章说「该功能属于数据中心模块」,改版后模块改名但功能归属不变,这句话可以保留,读者不会因此做错事。
必须重写成立的条件是:引用包含可执行步骤、数值限制或成本描述。重写时不要只把旧词替换成新词,而要重新核对步骤是否仍然成立。假设旧文写「在数据中心点击导出,选择 CSV,等待邮件通知」,改版后导出入口移到「数据管理」下的「下载」子项,且不再发邮件而是直接下载。此时只替换「数据中心」为「数据管理」仍然错误,因为后续步骤也变了。正确做法是按新流程重写整段,并在段落开头标注适用版本。
完成一批引用更新后,记录两件事:哪些旧名称已经全站清理,哪些旧名称仍允许出现在介绍性段落中。这份记录会成为下一次改版时的检索起点,避免每次从零排查。如果发现某类引用反复出现,说明旧文章的结构本身依赖了易变的界面细节,可以考虑把操作步骤集中到少数几篇文档中,其他文章只做概念性引用。这样下次改版时,需要改的范围会明显缩小。