先给结论:产品停产后,教程的替代方案要按“读者能否迁移”分两条路写。迁移成本低、替代品能力接近时,改写为迁移步骤;迁移成本高、替代品能力差距明显时,保留原教程并加停更说明与替代路径,而不是硬改步骤。判断依据是操作对象是否仍可获取、替代品是否改变核心流程,以及读者失败后能否自行回退。
如果停产品是某软件客户端,而替代品保留了导入、导出、批量处理等关键动作,只是菜单位置或命名变了,那么原教程的骨架仍然成立。此时应把每一步的动作对象换掉,而不是只替换产品名。例如原来写“在设置里导出为旧格式”,替代品可能把导出拆成“选择文件—导出—指定兼容格式”三步,这属于流程变化,必须补写。
实施动作:先按原教程完整走一遍替代品,记录每个失败点。失败点分为三类——入口消失、字段含义改变、结果格式不兼容。入口消失只需改描述;字段含义改变要说明新旧对应关系;结果不兼容则要加一步转换或提醒读者检查输出。做完这一步,再决定哪些段落删除、哪些段落保留。如果替代品能直接打开旧文件,就保留旧文件处理段落;如果只能新建,就删掉依赖旧文件的步骤,并在开头说明。
假设一个例子:某笔记工具停产后,替代品能导入旧笔记但不再支持标签树。原教程中“按标签树批量整理”的段落就应改为“导入后手动重建分类”,并注明标签会变成普通文本。这个假设说明的是判断方法,不是真实产品现状。
如果停产品是硬件、旧系统或已终止的合作接口,替代品往往不是简单替换,而是换了一套操作逻辑。此时把原教程改写成替代品教程,会让仍持有旧设备的读者失去参考,也会让新读者误以为步骤可以直接套用。更稳妥的做法是保留原教程主体,在开头加一段状态说明,再另起一节写替代路径。
状态说明要写清三件事:原对象已停产或停止支持、原文仍适用于仍持有它的读者、替代方案不保证操作步骤一致。替代路径一节只写迁移决策和新流程入口,不逐条复刻原教程。例如原教程是某旧版系统上配置打印共享,替代方案改为新系统时,不必把每个旧菜单截图换成新截图,而应说明新系统不再使用该共享方式,并给出新方式需要准备的条件,如账户类型、网络环境或权限要求。
实施动作:在原文顶部加一行状态标注,在文末加一段“如果你要迁移”的短说明,列出迁移前必须确认的两个条件。这样做的结果是,旧读者仍能按原文操作,新读者不会误入无效步骤,下一步再决定是否单独写一篇替代品教程。
这三个问题没有固定权重,但顺序不能颠倒。先确认对象是否还在,再判断流程差异,最后才考虑回退成本。若对象已完全不可获取、替代品流程差异又大,那么原教程的搜索价值会转向“历史参考”,此时应把标题和导言调整为面向仍持有旧对象的读者,而不是假装替代品可以无缝承接。
保留原文不等于原样不动。如果原文中的某个步骤依赖已关闭的在线服务、已失效的下载入口或已终止的合作关系,那么这一段必须删除或标注失效,不能因为“还有读者可能用到”就继续保留。判断标准是:该步骤是否依赖一个已经无法访问的外部对象。若是,保留它就等于让读者走进死路。
另一个例外是安全相关步骤。如果替代方案改变了权限、加密或账户验证方式,不能只写“类似操作”带过,应明确说明差异,并建议读者以替代品当前文档为准。这里不承诺任何具体工具或平台仍提供何种功能,只说明写作时应把变化点写出来。
最后,替代方案写完后的下一步不是立即发布,而是找一位仍持有旧对象或已迁移到替代品的读者试读。若对方能指出哪一步会卡住,就回到对应段落修改;若对方无法判断,说明状态说明和迁移条件还不够具体。