先给结论:改版后要回头的不是所有提到旧版本文档的句子,而是那些把旧版本文档当作当前事实来源的引用。判断标准只有一条——读者是否会因为这条引用去执行一个已经失效的动作。会,就必须改;只是叙述历史沿革,可以留。
产品文档改版通常伴随菜单层级、按钮名称、字段位置或权限路径的调整。如果旧文章里写的是“在后台左侧菜单进入 XX 设置”,而新文档已经把该设置合并到另一处,这条引用就从说明变成了误导。读者按旧路径找不到入口,会直接跳出,这条内容也就很难再获得稳定的排名表现。
处理动作分三步。第一,把旧文章里所有指向具体操作路径的句子单独摘出来,不要整篇重读,只找动词加位置的组合,例如“点击”“进入”“勾选”“在……下方”。第二,逐条对照新版本文档确认该动作是否还存在。第三,只替换失效的那一句,并在句尾补一句指向新版本文档对应小节的说明。
做完这一步会直接影响下一步:如果同一篇文章里有三条以上操作路径全部失效,说明这篇内容的主体已经过期,继续逐句修补的收益低于重写,此时应把它并入改版后的新文档体系,而不是保留旧骨架。
另一类引用写的是“早期版本采用 A 方案,后来调整为 B 方案”这类表述。它的作用不是指路,而是解释设计取舍。只要文中已经明确标注这是历史情况,且当前推荐做法指向新版本文档,这类句子不需要改动,改了反而会破坏叙述逻辑。
区分这两类的一个可操作办法是替换测试:把这条引用里的旧版本文档名称换成“某份已经下线的文档”,再读一遍。如果句子仍然成立,说明它只是背景;如果句子立刻变得无法执行,说明它是入口。
假设某产品把“导出报表”从设置页移到了数据页。旧文章写“在设置页点击导出”。改版后,这条引用属于入口类,必须改成“在数据页点击导出”,并补一句新版本文档的对应位置。同一篇文章里另一句“旧版把导出放在设置页,是为了减少主流程干扰”,属于沿革类,可以保留,但要确认它前后没有把读者引回设置页。
最常被忽略的不是正文步骤,而是文章开头的摘要句和文末的相关阅读列表。摘要句往往压缩了操作路径,改版后它比正文更早失效;相关阅读列表里的旧文章如果同样基于旧路径,会形成连环误导。处理时先改摘要句,再检查列表中被链文章的入口是否仍然有效。这一步的结果决定你是否需要连带更新那几篇被链文章,而不是只改当前这篇。
如果新版本文档尚未正式对外,或者旧路径仍然保留可用,此时改动会造成新旧两套说法并存,读者反而更困惑。另一种情况是文章本身已经明确标注适用于某个历史版本,并放在版本归档区,这类内容保留原样更合理。判断依据是读者当前能否按照文中描述完成任务,而不是文档内部版本号是否变化。
把这些引用按入口类和沿革类分开处理之后,你会发现需要实际动手修改的句子通常远少于最初估计,而真正决定文章是否继续有效的那几条,恰恰藏在摘要和路径描述里。