先给结论:产品文档改版后,旧文章里需要更新的引用,不是所有提到产品的段落,而是那些依赖已变更事实、且读者会据此做下一步动作的引用。判断依据只有一条——这个引用是否还指向当前可验证的产品行为。属于旧版界面、旧字段名、旧流程顺序的引用要改;属于产品定位、通用概念、用户自身操作习惯的引用通常可以保留。
假设某工具的产品文档做了一次改版:把原来的“导出设置”拆成了“导出范围”和“导出格式”两个独立步骤,字段名从“导出选项”改成了“导出配置”,同时删掉了旧版的一个批量导出入口。你手里有一批围绕长尾关键词库写成的旧文章,其中若干篇在操作段落里引用了这套流程。
单看一两篇,你会觉得“只要把字段名换掉就行”。但规模化检查整批文章时,例外就出现了:有些文章引用的是字段名,有些引用的是入口位置,有些引用的是操作顺序,还有些只是用产品举例说明一个通用概念。这四类引用的更新成本和处理方式完全不同,不能一刀切。
把旧文章里的引用拆成四层,逐层判断:
分层的意义在于:前两层是“改词改步骤”,后两层可能牵动整段论证。先分层,再决定投入多少编辑成本。
具体做法是,在旧文章里把所有涉及产品行为的句子单独抽出来,逐条标注它属于上面哪一层,并记录该行为在改版后的状态。可以这样记录:
这个动作的结果会直接影响下一步:如果标记后发现“已移除”的引用集中在结论层,说明这批文章的核心论据受损,优先重写;如果集中在事实层,说明只是维护性替换,可以批量处理。两种情况的排期和人力投入不一样,先标记能避免把重写工作当成改词工作来做。
单篇检查时,你容易凭记忆判断“这句还能用”。但批量处理时,记忆不可靠,例外会累积:同一字段名在不同文章里可能对应不同语境,有的指界面,有的只是泛指;同一入口在有的文章里是操作前提,在有的文章里只是顺带一提。这些差异在单篇里看不出来,规模化后才会暴露。
所以边界是:分层规则可以复用,但每篇文章的引用状态必须逐条核对,不能拿一篇的结论套到整批。同义词替换在这里没有价值——把“导出选项”改成“导出配置”如果没核对实际字段,可能改出一个文档里根本不存在的名字。
不是所有旧引用都要更新。以下情况可以保留:
保留的前提是:这个引用不会让读者产生“按它操作就能完成”的预期。一旦读者可能照着做,就必须核对当前状态。
需要说明的是,旧文章流量下降、页面抓取减少,都不能单独证明“引用该更新了”。流量变化可能来自选题老化、竞争内容增加、用户需求转移等多种原因,与引用是否过期没有必然因果。判断引用是否要改,依据始终是产品行为的当前状态,而不是页面表现。
落到操作上:先分层标记,再按“已移除的结论引用优先、事实引用批量替换、示例引用按需保留”的顺序处理。这样改完之后,旧文章与新文档之间不会留下会让读者走错路的引用,也不会把不需要动的段落改得面目全非。