先给结论:产品停产后,教程页不要整篇删除,也不要把旧步骤原样留着。更稳妥的做法是先判断“读者来这一页要完成什么任务”,再决定是保留原教程、在顶部加替代路径,还是把页面改写成任务导向的替代方案。判断依据不是页面访问量高低,而是旧产品是否仍有人使用、替代方案是否真的能完成同一任务。
这两种情况的写法完全不同。
条件一:旧产品仍有人用,只是不再更新。此时教程本身仍有价值,读者可能正在维护旧系统、旧设备或旧合作关系。不要删掉原步骤,而是在页面顶部加一段“当前状态说明”,写清楚它已停止更新、哪些步骤仍可执行、哪些依赖已经失效。替代方案放在原教程之后,作为“如果你要迁移”的补充路径。
条件二:旧产品已无人维护,替代方案能完整覆盖原任务。此时原教程的每一步都在把读者引向死路。应把页面主体改写成替代方案,旧内容压缩成一小段背景说明,保留它的历史价值,但不让它占据主要阅读路径。
判断依据可以看三个信号:旧产品是否还有活跃的讨论或求助;替代方案是否能完成原教程的最终目标;旧教程里的外部依赖是否已经失效。三个信号里,只要“替代方案能完成同一任务”这一条不成立,就不要急着改写。
最常见的失败写法是:“A 已停产,建议改用 B。”这句话对读者几乎没有帮助,因为读者不知道 B 能不能完成原来那件事。
可用的替代方案至少要交代四件事:
一个假设例子:某教程教读者用旧版命令行工具导出数据,工具停产后,替代方案不是写“改用新工具”,而是写清楚新工具的导出命令、输出格式差异,以及旧脚本里哪一行需要替换。读者照着改完能跑通,这一页才算完成替代。
具体可以按这个顺序做。
这个动作的结果会直接影响下一步:如果加了状态说明后读者仍能完成任务,就保留原结构;如果读者仍在失效步骤上卡住,就必须改写主体,而不是继续加提示。
不是所有停产教程都值得改写。以下情况可以只做轻微处理:
这些情况下,加一句状态说明、把页面标题或摘要写清楚即可,不必强行塞入替代方案。硬写替代方案,反而会降低这一页的可信度。
写完替代方案后,用一句话检验:一个从没接触过旧产品的读者,能不能只靠这一页完成原来的任务?能,说明替代方案写到位了;不能,说明还停留在“给个名字”的阶段。
另外要说明一点:页面访问量下降、搜索请求减少,都不能单独证明改写正确。它们可能有多种解释,比如季节性波动、读者转移到其他入口,或者旧对象本身的使用场景在收缩。判断改写是否有效,应该回到任务是否还能完成,而不是只看某一项数字的变化。
产品停产后教程的处理,本质上是一次内容取舍:保留仍然有价值的部分,把已经失效的部分替换成能走通的路径。先判断条件,再决定保留还是改写,最后用“读者能否完成任务”来验收,这一页就不会变成没人敢删、也没人敢用的死内容。