先给结论:旧文章里需要更新的引用,不是所有提到旧产品名的地方,而是那些“读者会照着去执行、去核对、去跳转”的引用。改版后,把旧文章分成三类处理:会误导操作的直接改,仅作背景说明的补一句时间限定,纯历史记录且不影响理解的保留。没有完整后台数据或编辑权限时,最小动作是先把旧文章里的操作步骤、参数名、界面名称和跳转路径逐条核对一遍,而不是先改措辞。
产品文档改版后,常见的情况是旧文章仍然有访问,甚至读数看起来正常,但文章里引用的按钮名称、菜单路径、字段含义已经和新版对不上。这时容易得出两个相反判断:一种认为既然还有访问,说明内容仍然有效;另一种认为文档都换了,旧文一律作废。
两种判断都可能出错。访问量、停留或抓取量保持,并不能单独证明引用仍然正确——它也可能来自读者找不到新入口、在旧页面里反复试错,或者只是搜索结果的摘要还没更新。反过来,把旧文全部重写,也可能删掉仍然成立的背景解释,让本来能解决问题的段落消失。
解释一:旧文承担的是“入口”角色。文章本身是操作路径,读者按步骤点击。这种情况下,任何按钮名、菜单层级、字段默认值的变化都会直接造成操作失败,必须优先更新。
解释二:旧文承担的是“解释”角色。文章说明为什么这样设计、某个概念怎么理解,界面名称只是顺带提及。这种情况下,旧名称不影响结论,只需要在首次出现处补一句“新版界面中对应位置已调整”,不必逐字替换。
区分这两种解释的证据,不是文章发布时间,而是读者接下来要做什么。如果段落末尾引导读者去某个页面完成动作,它属于第一种;如果段落是在解释原因、比较方案或说明限制,它属于第二种。另一个可用的证据是:把该段单独摘出来发给一个不熟悉改版的人,他能否在不返回原文的情况下继续操作。不能,就按入口处理;能,就按解释处理。
没有完整访问日志、没有编辑后台、也拿不到新版文档的完整变更记录时,不要停在“等数据齐了再改”。可以执行的顺序是:
这个动作的结果会直接影响下一步:如果核对后发现大量引用都指向已经移除的功能,说明旧文需要整体标注或合并;如果只是少数名称变化,逐处修正即可,不必重写全文。
假设某产品把设置页里的“同步频率”改名为“更新周期”,并把原来的三个选项合并为两个。旧文中有三处引用:
这个例子的数字只是用来说明分类方法,不代表任何真实产品的现状。关键判断依据始终是:读者读完这一句,下一步会不会照着做。
修正引用之后,不能因为页面读数没有立刻变化就断定改错了,也不能因为读数上升就断定是这次修改带来的。读数变化还可能来自季节、渠道、搜索结果摘要更新或读者结构变化。可以确认的只有一件事:旧文中会误导操作的引用已经减少。至于是否继续处理“只是叫法不同”的引用,取决于这些段落是否还承担入口作用——如果它们只用于解释,保留旧称并加时间限定,通常比机械替换更清楚。