先给结论:产品文档改版后,旧文章里需要更新的不是所有带链接的句子,而是那些“引用内容已改变、但读者仍会按旧文理解并行动”的位置。判断标准可以落到三个可核对项:被引用的定义或参数是否变了、旧文给出的操作步骤是否仍能走通、旧文承诺的结果是否还成立。三项中任一为“是”,该处引用就进入待更新清单。
假设某团队把一份产品文档从“按功能模块组织”改成“按任务场景组织”,原文档里的接口名、字段名和默认值也做了调整。此时内容编辑说“只是改版,链接没断就不用动”,产品经理说“旧文里的说明已经不对了”,SEO负责人说“先看有没有流量再决定”。三方分歧的根源是各自在回答不同问题:编辑在核对链接可达性,产品在核对事实准确性,SEO在核对访问价值。
把分歧转成项目,可以建一张核对表,每行是一处引用,列至少包含:旧文位置、引用的是定义/参数/步骤/结论中的哪一类、新文档对应内容是否变化、读者按旧文操作会发生什么、处理动作。这样讨论就从“要不要全改”变成“这一行判为哪种处理”。
不是所有引用都同等重要,按性质分开处理,能避免两种极端:要么全部重写,要么只改死链。
四类里,定义和参数类偏事实,步骤类偏可执行,结论类偏判断。事实错了是硬伤,判断过时是软伤,但软伤同样会让读者做出错误决策。
一个成本低、能产生证据的动作是:从旧文中挑出引用最密集的一篇,让不熟悉改版的人按旧文从头操作一遍,记录卡点。这个动作的结果直接决定下一步:
这个动作的价值在于把“我觉得过时了”变成“第几步卡住、卡住的原因是什么”。后续排优先级时,卡点越多、越靠前的文章越先处理。
只换链接文字不改上下文。把旧功能名替换成新名,但前后文还在描述旧逻辑,读者会更困惑。替换术语时要连带检查同段内的解释句。
把旧文整篇重写成新文档的复述。旧文如果有独立的搜索需求和使用场景,整篇覆盖会丢掉它原本回答的问题。更稳的做法是保留旧文的问题框架,只替换事实层内容。
用访问量作为唯一取舍依据。访问量低的旧文如果引用的是错误参数,仍可能在少量读者那里造成实际误操作。访问量可以作为排序参考,但不能单独证明某处引用无需更新。反过来,访问量下降也可能只是季节波动或入口变化,不能直接推断为内容过时。
每处理完一处引用,在核对表里补上:处理日期、处理方式(更新/保留加注/合并/删除)、依据(新文档哪一节)、复查触发条件(例如该文档再次改版或该参数再次调整)。复查触发条件比固定复查周期更实用,因为它把“什么时候需要再看”绑定到真实变化上。
如果同一处引用在多个旧文中重复出现,先确认哪一篇是该事实的“主承载页”,其余位置改为指向主承载页或做简短说明,避免下次改版时同一事实要在多处同步。这个动作的结果是:下一次文档改版时,需要核对的引用位置数量会明显减少,分歧也更容易收敛到少数几页。