旧产品停产后,教程里最危险的做法不是删掉旧文,而是把“替代方案”写成一句“请使用新产品”。读者往往正卡在旧版本上,需要的是迁移路径,不是被推销。判断该保留还是重写,关键看旧教程是否仍能解决一部分问题,以及替代方案是否改变了操作前提。
产品停产后,旧教程可能仍有稳定访问,但读者反馈从“怎么装”变成“装不上怎么办”“还能继续用吗”“新版本里对应哪一步”。如果只看页面访问量,容易误判为内容仍然有效;如果只看“已停产”三个字,又容易把仍有参考价值的步骤一并删掉。
这两种反应背后是两种解释:一种认为旧教程已经失效,流量只是惯性;另一种认为旧教程仍覆盖通用原理,只是缺少迁移出口。能区分它们的证据不是访问量本身,而是读者在页面上的行为:是否反复搜索报错信息、是否在评论区或工单里询问替代品、是否跳出后继续找同一旧版本的资料。若出现后一种信号,说明页面需要补替代路径,而不是简单下架。
把教程拆成三类内容,比整篇判断更可靠。
一个实际动作是:在旧教程开头加一行“适用版本与状态说明”,列出最后验证的版本和已知失效环节。这样做会直接影响下一步——如果只有外部依赖失效,补一段迁移说明即可;如果核心操作已经无法复现,则应把旧文改为历史参考,并另写一篇面向现用方案的教程。
替代方案不是推荐列表,而是一条从旧状态到新状态的路径。至少应包含四个要素:旧方案当前还能做什么、替代方案改变了哪个前提、迁移时先做哪一步、失败后如何回到旧方案。
假设一个旧版插件停产后,新版插件不再支持原来的配置文件格式。可以这样写:先说明旧配置仍可导出为通用格式,再给出新版导入时的字段对应关系,最后提醒先备份原文件。这里的数字和步骤只是假设示例,用于说明比较方法,不代表任何真实产品的现状。
如果替代方案需要额外成本、权限或学习时间,应直接写出适用条件。例如:仅当团队仍在使用旧系统时,保留旧教程的只读说明;若已经升级,则跳转到新教程。这样读者能自己判断该走哪条路,而不是被一句“建议升级”卡住。
可以按以下顺序收集证据,再决定动作。
一个可区分的证据是:读者是否在寻找“旧版本还能不能继续用”的确认。如果这类问题集中出现,保留旧教程并补充退出路径,比直接删除更能减少重复提问。反之,如果读者已经在问新方案的具体操作,旧教程就应退为背景资料,把主要入口让给新文。
第一,把替代方案写成产品广告,只讲新方案优点,不讲迁移代价。第二,用同义词机械替换旧步骤,看似更新,实际没有解决版本差异。第三,把旧教程全部删掉,导致仍在使用旧版本的读者失去唯一参考。
更稳妥的做法是:在旧教程中保留仍然成立的部分,明确标注已失效的部分,并给出一个可执行的下一步。这样既尊重旧内容的历史价值,也让新读者能顺着迁移路径继续操作。最终判断标准不是页面是否提到新产品,而是读者能否根据页面完成从旧状态到可用状态的过渡。