产品文档改版后,旧文章里的引用不是按“新旧”一刀切,而是按它是否仍能帮读者完成当前动作来取舍。缺少全站数据和后台权限时,最小动作是:先列出旧文章中所有指向产品文档的链接、截图、版本号、功能名称和操作步骤,再逐条判断保留、改写或退出。保留适用于引用对象没变且仍可访问;改写适用于对象还在但名称、路径或界面变了;退出适用于对象已不存在或无法核实。这个动作的结果会直接决定你下一步是只改链接,还是连整段解释一起重写。
旧文章里的引用通常分四类:指向文档页面的链接、嵌入的界面截图、引用的功能名称或版本号、以及依赖旧流程的操作说明。它们的处理前提不同。
这里没有统一阈值。判断依据是:读者照着旧文章操作,能否在不额外求助的情况下完成目标。不能,就不该保留原样。
没有后台日志、没有编辑权限、拿不到文档变更记录,仍然可以做一件事:用公开可见的页面做抽样核对。具体动作是,从旧文章中挑出引用最密集的三到五篇,逐条打开引用目标,记录三种状态:可访问且内容一致、可访问但内容已变、不可访问或无法核实。
这个动作的结果会影响下一步:
需要说明的是,抽样中某类问题集中出现,只能说明这批样本里该问题多,不能直接推出全站旧文章都需要同样处理。请求量下降、抓取异常或页面收录变化,也可能由改版之外的模板、服务器或站内结构调整引起,不能单独作为“引用必须更新”的证据。
同一处旧引用,在不同文章里的处理可能不同。关键看它是否承担核心论证。
假设例子:某篇旧文章用一段产品文档截图说明“如何导出报表”。改版后,导出入口从设置页移到了报表页。若该截图只是辅助说明,改写图注并补一句“入口位置以当前文档为准”即可;若整篇文章的结论建立在“设置页可导出”这个前提上,则必须改写操作段,否则结论失效。这个例子只用于说明比较方法,不是真实项目记录。
适用条件:改写适合引用对象仍存在、只是表述或位置变化的情况;退出适合引用对象已消失、无法核实,或继续保留会误导读者的情况。若引用对象仍在但你不确定新路径,保留原文并加一句待核实提示,比直接删除更稳妥。
改完引用后,可执行的最小验证是:重新走一遍旧文章里的关键操作路径,确认每一步都能到达预期页面或结果。若某一步仍失败,回到该引用,判断是链接问题、步骤问题还是文档本身的问题。
验证时要注意:
把“引用是否仍能帮读者完成任务”作为唯一判断轴,保留、改写或退出就有了可执行依据,而不是靠新旧或感觉来决定。