先给结论:产品文档改版后,旧文章里需要优先更新的不是所有带链接的句子,而是那些“引用内容已经改变,但读者仍会按旧结论行动”的位置。判断标准可以落到三类:被引页面的结论变了、被引页面的入口或名称变了、被引页面虽然还在但已不再是最合适的目标。只改链接文字、不改读者行动依据,通常不够。
打开你手上任意一篇旧文章,把所有对外引用逐个标出来,不用先判断对错,只做归类。第一类是结论引用,例如“按照产品文档,默认开启某功能”。第二类是路径引用,例如“在设置页找到某开关”。第三类是推荐引用,例如“更完整的说明见另一篇文档”。这三类对应不同的更新动作,混在一起改容易漏。
标记时保留原句,不要边读边改。全部标完后,再回到产品文档改版说明,逐条比对。改版说明里明确写了“旧字段已废弃”的,对应结论引用;写了“页面结构调整”的,对应路径引用;写了“内容合并到新文档”的,对应推荐引用。这个动作的结果是得到一张按引用类型分组的清单,下一步才能决定哪些先改。
结论引用最危险,因为读者往往只记住一句话就去操作。判断是否必须更新,看两个条件是否同时成立:旧文章里的结论在产品文档改版后已经不成立,并且读者按旧结论操作会产生实际偏差。两个条件都成立时,应优先改,而不是等下次整体修订。
如果旧结论只是表述过时、操作结果不变,可以降低优先级。这里要避免一个常见误判:把“产品文档改版”直接等同于“所有旧结论都失效”。改版可能只调整了排版或补充了示例,核心结论未变。此时更新引用反而增加维护成本。可以用一个假设例子说明比较方法:假设旧文章写“提交后需等待审核”,新文档写“提交后即时生效”,这就是结论变化;若新文档只是把同一句话换了位置,则不算。
路径引用包括菜单名称、按钮文字、字段位置和操作顺序。产品文档改版后,只要读者按旧路径找不到目标,这篇旧文章就需要更新,哪怕结论本身没变。判断依据不是“文档改版了”,而是“旧路径在新文档里是否还能走通”。
实际操作时,可以按旧文章里的路径在新文档中走一遍。走不通的位置,改成新路径;走得通但名称不同的,至少补一句新旧名称对应,避免读者困惑。这个动作的结果会直接影响下一步:如果走不通的位置超过一定数量,说明这篇旧文章的结构可能也需要调整,而不只是替换几个词。
推荐引用常被忽略,因为链接没有断。产品文档改版后,旧页面可能仍可访问,但内容已被新页面取代,或者新页面更适合作为首选参考。此时需要判断的是“推荐目标是否仍然最优”,而不是“链接是否有效”。
可以用两个条件区分:旧页面是否仍覆盖当前产品状态;新页面是否在完整度和更新程度上明显更合适。若旧页面只是历史版本,应把推荐指向新页面;若旧页面仍是最具体的说明,只是入口变了,则保留链接并更新路径描述。这个判断会影响后续的内部引用策略:当同一主题出现多个候选页面时,旧文章应统一指向当前维护的那一个,减少读者在多个页面间来回跳转。
更新完成后,不要只检查改过的句子。从清单里随机抽几条结论引用和路径引用,按更新后的内容重新走一遍,确认读者能按新引用完成操作。抽查的重点是“行动是否顺畅”,不是“链接是否可点”。
如果抽查中发现同一类引用反复出问题,例如多个旧文章都引用了同一个已废弃字段,说明需要回到关键词库对应的内容分组,把同类引用集中处理一次,而不是逐篇修补。这个动作的结果是减少后续重复劳动,也让旧文章的更新顺序更清楚:先处理会导致错误行动的结论引用,再处理找不到入口的路径引用,最后处理推荐目标不再最优的引用。