先给结论:产品停产后,教程里的替代方案不是“把旧型号换成新型号”那么简单。更稳妥的做法,是把替代方案拆成“保留原步骤、改写为通用方法、明确退出旧路径”三种处理,并让每个判断都能被核对。这样做的原因很实际:同一篇教程面向的读者,可能有人还在用旧产品,有人已经换成替代品,还有人只是来找迁移思路。三种人需要看到的不是同一套说法。
保留的前提是:旧产品仍有一批使用者,且教程里的操作步骤没有因为停产而失效。比如某个设备停产后,固件下载入口可能还在,但官方支持页面已经不再更新。这时教程可以保留原有步骤,但必须补一句“该产品已停产,以下步骤仅适用于仍在使用旧设备的读者”。
如果旧产品已经无法获得配件、授权或安全更新,继续把旧步骤放在主路径就会误导读者。更合适的处理是把它降为历史说明,把通用方法提到前面。判断依据不是“这个产品还搜不搜得到”,而是“读者照着做还能不能完成目标”。
实际动作:把教程里的每个步骤标成“依赖旧产品”“依赖替代品”“两者都可”。标完之后,你会发现有些步骤其实根本不需要绑定具体型号,这类步骤可以保留,但要把型号名从标题和首段里拿掉。
替代方案最容易写坏的地方,是只写“换成某类产品即可”,却不写哪些条件变了。更可核对的写法是列出三件事:替代品能覆盖原教程的哪些目标、哪些步骤需要重做、哪些结果不再保证。
假设一个场景:某款软件停产后,教程原本教读者用它的导出功能生成报表。替代方案可能是改用另一款工具,也可能是改用通用格式手动整理。两种写法成立的条件不同:如果读者只是偶尔导出,手动整理可能够用;如果读者要批量处理,就需要工具支持。教程不需要强行推荐其中一种,但要把选择条件写出来。
动作与结果:在替代方案段落里加一行“如果你原来的用途是A,优先看B;如果只是C,可以跳过D”。这行字会直接影响读者下一步是继续读还是离开,也能减少他们把旧步骤套到新产品上。
停产后教程常出现一种情况:写教程的人认为替代方案已经讲清楚,维护支持的人认为旧步骤不该再出现,读者则以为旧产品还能按原样用。三方不是谁对谁错,而是各自掌握的事实不同。
把分歧转成核对项,比在文章里争论更有效。可以列出:旧产品是否还能获得官方支持、替代方案是否经过实际验证、教程中的命令或界面是否仍然一致。每个核对项只回答“是、否、不确定”,不确定的就不要写成确定结论。
适用条件:如果教程只是个人笔记,核对项可以少一些;如果教程会被其他同事、客户或读者当作操作依据,核对项就要写进正文,而不是留在编辑备注里。
有些停产后教程不适合再保留旧路径。比如旧产品已经无法安全使用,或者替代方案的成本远低于继续维护旧方案。这时“退出”不是把旧内容删掉,而是把读者引到一个明确动作:迁移数据、更换工具、改用新流程,或者确认自己不需要继续。
退出的写法要避免两种极端:一种是只写“建议升级”,不给具体动作;另一种是把替代方案写成唯一正确路径,忽略读者可能只是来查旧资料。更稳的写法是:先说明旧路径为什么不再适合作为主路径,再给出一个最小下一步,比如先导出数据、先确认替代品是否支持原格式、先备份旧配置。
动作与结果:如果读者完成最小下一步后发现自己不需要替代方案,教程就应该允许他们停在这里。这个结果会影响你下一步是继续补迁移细节,还是把文章改成“旧产品停用后的检查清单”。
最后,把替代方案从一段说明变成一组可核对的项目。每个项目至少包含:原教程中的目标、替代方案对应的动作、成立的前提、读者需要自己确认的事实。这样写不会让文章更长,但会让读者更容易判断自己该用哪条路径。
例如,原教程目标是“生成月度报表”,替代方案动作是“用通用格式导出后手动整理”,成立前提是“报表数量少、格式固定”,读者需要确认的是“替代工具是否支持原导出格式”。这四句话比“换成新工具即可”更有用,也更容易在停产后长期维护。