先给结论:需要更新的不是所有提到旧文档的句子,而是那些让读者按图索骥却会走错路的引用。判断标准只有一条——读者照着你写的路径操作,会不会得到与文中描述不同的结果。会,就必须改;不会,可以留。改版后最容易被忽略的,恰恰是那些只写了功能名、没写具体路径的“软引用”,它们看起来没过期,实际已经指错了地方。
把旧文章里的引用分成两类,处理方式完全不同。
条件一:引用包含可点击链接或明确路径。这类引用最容易被发现,因为链接会失效、路径会跳转。但发现不等于处理正确。如果新文档只是换了地址、内容结构没变,把链接替换成新地址即可,正文描述不用动。如果新文档把原来的三步操作合并成两步,或者把“设置”挪进了“高级选项”,那就不只是换链接,正文里的步骤描述也得跟着改。判断依据是:读者点进去之后,能不能在页面上找到你正文里说的那个按钮或字段。找不到,正文和链接一起改。
条件二:引用只提功能名,不给路径。这类引用最危险,因为它不会报错。比如旧文写“在账户设置里开启自动同步”,改版后这个开关移到了“数据管理”下,句子本身读起来仍然通顺,但读者按字面去找会扑空。处理方式是:先确认这个功能名本身有没有变。功能名没变、只是位置变了,就在句子后面补一句新的位置描述;功能名也变了,就把旧名替换成新名,并在首次出现时用一句话交代新旧对应关系,避免老读者困惑。
不要凭记忆判断哪些引用过期。挑出旧文章里所有涉及产品操作的段落,逐段按文中描述实际走一遍。走不通的地方记下来,走通了但中途需要绕路的地方也记下来。这个动作的结果直接决定下一步:走不通的必须改,绕路的看绕路程度——如果读者需要自己猜一步才能继续,就补上那句缺失的说明;如果只是多点一次、不影响理解,可以暂时不动,留到下次内容维护时一起处理。
核查时注意一个反常现象:有些引用在改版后反而“更对”了。比如旧文写的路径恰好和新版一致,或者旧文描述的操作在新版里被简化后,读者更容易完成。这类引用不需要改,改了反而浪费人力。核查的价值就在于把“需要改”和“看起来需要改”分开。
三类引用可以延后处理。第一类,指向外部资源的引用,只要对方页面还在、内容相关,产品文档改版不影响它。第二类,纯概念解释里提到的功能名,读者不需要按它操作,只是理解背景,功能名没变就不用动。第三类,已经明确标注了适用版本或时间的段落,读者看到标注就知道可能不是最新,改版后可以保留,等下次大修时统一处理。
但有一个例外:如果旧文章是某个操作流程的唯一说明,而新文档又没有覆盖这个流程,那这篇旧文里的引用就必须优先改,甚至要在文首加一句提示,说明该流程在新版中的位置。否则读者会以为这篇旧文仍然是最佳入口。
假设某产品把“导出报表”从顶部菜单移到了每张报表的右键菜单里。改版后,一篇旧教程的访问量没有明显变化,甚至因为改版新闻带来的关注略有上升。这时候不能因为流量没跌就认为引用不用改。流量可能来自品牌词搜索、外部转载或用户直接收藏,这些渠道的读者进来后照样会按旧路径找导出按钮,找不到就离开。要区分这两种解释,可以看页面上的下一步行为:如果读者在教程页停留时间正常但跳转到产品页后的操作完成率下降,更可能是路径描述失效;如果停留时间也同步下降,才更可能是内容本身不再匹配需求。这个例子里的数字只用于说明比较方法,不代表任何真实站点的表现。
每改一处引用,在内容记录里写清楚三件事:旧引用指向哪里、新引用指向哪里、改动依据是哪次核查。这样下次文档再改版时,你可以直接按这份记录筛选出受影响的范围,而不是重新全量走一遍。记录本身不需要复杂,一段话或一张清单就够,关键是让下一个人能看懂为什么改、改成了什么。
如果改版频繁,可以把引用分成“强依赖”和“弱依赖”两档:强依赖指读者必须按它操作才能完成任务,每次改版后都要核查;弱依赖指仅作背景提及,可以两个版本核查一次。分档的依据是读者失败的成本,不是引用出现的次数。