产品文档改版后,旧文章里的引用不是都要改,也不都能留。判断标准是那句引用是否仍能让读者完成当前动作。如果旧引用指向的动作、字段名或入口已经变了,保留它就会把读者带偏;如果只是页面位置变了,改写链接通常比删掉整段更划算。下面按保留、改写、退出三种处理分别说明适用前提,并给出一个可执行的核对顺序。
旧文章里的引用大致分三类,处理方式不同。
把这三类分开之后,你会发现需要集中处理的往往只有动作型引用。很多站点改版后全量替换链接,结果把本来还能用的概念型引用也改乱了,反而增加了新的错误。
满足下面两个条件时,可以保留旧引用,只做一次链接可达性检查。
假设一个旧页面写“在账户设置中开启通知”,改版后入口从“账户设置”移到“通知偏好”,但开关名称和效果都没变。这种情况下保留原文、只更新链接,比重写整段更省事,也不会破坏原有上下文。保留不是不管,而是把改动限制在引用目标上,避免牵动正文其他部分。
当读者要完成的动作没变,只是到达方式变了,改写比删除更合适。改写时优先改三处:字段名、入口名称、步骤顺序。改完以后,用一个具体动作验证结果,比如让不熟悉该功能的人按新步骤走一遍,看是否卡在某一环。这个动作的结果会直接决定下一步:如果对方能独立完成,说明改写到位;如果仍要追问,说明还缺一句前置条件,需要补进正文而不是只改链接。
需要注意,改写不是把旧词换成同义词。把“点击保存”换成“点按存储”并不会让引用更准确,反而增加理解成本。真正需要改的是读者看到的界面文字和实际路径。
如果改版后该动作被合并、取消或拆到另一个流程里,旧引用就没有保留价值。这时退出有两种做法:删掉整段,或保留一句说明并指向新的替代动作。选择哪一种,取决于这段引用在原文中承担多少分量。
退出的判断依据不是“页面打不开”,而是“读者按旧引用做不成事”。链接失效只是表象,动作消失才是根因。反过来,链接暂时打不开也不等于动作消失,可能只是跳转规则还没配好,这种情况应先确认目标是否仍存在,再决定保留还是改写。
面对一批旧文章,可以按下面顺序处理,避免反复返工。
这个顺序的价值在于把工作量集中在真正会误导读者的地方。概念型和证据型引用通常占多数,但它们往往不需要动,先处理动作型引用能更快看到效果,也更容易判断下一步该扩大还是收缩改动范围。
有时你会发现某些旧引用的点击或访问在改版后明显下降,甚至归零。这不能单独证明这些引用应该删除。下降还可能来自入口位置变化、页面加载方式调整、读者路径改变,或者只是统计口径换了。把归零直接当成删除依据,容易误伤仍然有效的概念型引用。更稳妥的做法是回到动作是否还能完成这一条,用实际走查代替单一指标判断。
处理旧引用时,真正要回答的问题始终是:读者顺着这句话,能不能完成他原本要做的事。能,就保留;路径变了但事还能做,就改写;事做不成了,就退出。按这个标准逐条过一遍,比按改版时间或链接状态批量处理更可靠。