结论先行:产品文档改版后,旧文章里需要优先更新的不是所有带链接的句子,而是那些把旧界面、旧参数或旧流程当作当前事实来陈述的引用。判断标准是引用是否承担了“操作依据”功能——读者会照着它去点、去填、去判断对错。如果只是提及产品存在过某个功能名称,且改版没有改变该功能的语义,可以暂缓。反例是:当改版只调整了页面布局和按钮位置,但字段含义、校验规则和返回结果完全没变,此时把旧文章里的截图说明全部重写,属于过度更新,反而可能引入新的描述偏差。
旧文章里的引用大致分三类,处理方式不同。第一类是操作路径引用,例如“在设置页点击导出按钮,选择时间范围后确认”。这类引用最容易失效,因为改版常把入口从一级菜单挪到二级菜单,或把单页表单拆成两步。第二类是参数与字段引用,例如说明某个配置项的取值含义、默认值或单位。第三类是概念与命名引用,例如旧文章把某个模块叫“任务中心”,改版后改名为“作业管理”。三类里,操作路径和命名变化最需要动,参数含义若未变则不必跟风改。
一个可操作的区分办法:把旧文章里的引用逐条问一句“读者会不会拿它去对照当前产品界面”。会对照的,归入操作路径类;只用于理解概念的,归入命名类。命名类更新成本低但优先级不一定高,因为读者即使看到旧名称,多数能从上下文推断对应关系;操作路径类一旦错位,读者会卡在第一步,直接影响后续阅读和转化。
不要一上来就逐篇重写。先做一次引用密度盘点:在旧文章里标出所有涉及产品界面、字段、流程的句子,统计每篇文章中这类句子的占比。占比高的文章,改版后风险大,应优先处理;占比低、以原理和思路为主的文章,可以放到后面。这里的密度是内部盘点用的相对指标,不是对外承诺的阈值,也没有统一标准说超过多少就必须改。
盘点时注意一个常见遗漏条件:交叉引用。旧文章A引用了旧文章B里的操作步骤,而B已经更新,A却没有同步。这种情况下,A里的引用即使文字没变,指向的已是过时内容。处理办法是先更新被引用方B,再回查所有引用B的文章,把A里的步骤替换为对B的指向,而不是在A里重复维护一份会再次过期的步骤副本。
假设某产品文档改版,把“创建规则”从单页表单改成三步向导,字段名称和校验逻辑不变。旧文章里有两处引用:一处写“在创建规则页填写名称和条件”,另一处写“规则名称支持中文和字母”。前者描述的是路径,改版后读者找不到单页表单,需要更新为“按向导依次填写名称、条件和生效范围”;后者描述的是字段规则,改版未改变校验逻辑,可以保留。这个例子的比较方法是:看引用描述的是“去哪里做”还是“做的规则是什么”。前者随界面变,后者随产品逻辑变。若产品逻辑也变了,则两类都要改。
盘点之后,建立一个简单的引用台账,字段包括:旧文章地址、引用类型、被引用的产品文档版本、是否已核对、处理动作。每次产品文档改版,先更新台账里标记为“操作路径”和“命名”的条目,再逐条回查旧文章。回查时只改与本次改版相关的引用,不顺带重写无关段落,避免一次改动引入新的不一致。
完成一轮后,观察旧文章在站内搜索和外部搜索中的表现变化。如果某些文章点击和停留没有明显变化,不要立刻断定更新无效,因为改版影响、抓取延迟和读者需求变化都可能同时存在。更稳妥的做法是记录改动日期,过一段时间再对比同一批文章在改版前后的表现,并优先处理那些引用错误已经影响读者完成任务的页面。这样,下一步是继续回查剩余引用,还是转向内容结构优化,就有了依据。