结论先给:如果停产产品在教程中仍承担关键步骤,替代方案应当写成“迁移路径”而不是“推荐清单”,先交代旧方案为何失效,再给出一条可验证的新路径;如果停产产品只是可选工具,正确做法是保留原理、换掉工具名,并把差异写成条件句。判断依据不是产品是否还能买到,而是读者照着教程做时会不会在同一个环节卡住。
把停产产品分成两类,写法完全不同。第一类是“必经节点”:教程的后续步骤依赖它的输出格式、接口行为或配套耗材,缺了它,后面全部走不通。第二类是“可替换工具”:它只负责完成一个通用动作,比如压缩图片、转换编码、批量重命名,换成别的工具,结果一样。
区分方法很直接:把产品名从教程里删掉,看剩下的步骤是否还能连成一条完整链路。如果删掉后出现“然后导入刚才生成的文件”却没人生成这个文件,它就是必经节点,必须写迁移路径。如果删掉后只是少了一个操作入口,步骤逻辑仍然完整,它就是可替换工具,写替代时点到为止即可。
这个判断决定了篇幅分配。必经节点值得用一个小节讲清楚替代前后的差异;可替换工具只需要在首次出现处加一句条件说明,不必为它单独开一段。
写成“推荐清单”的常见毛病是只列名字,不交代代价。读者换了一个工具,发现输出格式变了、参数名不一样、默认行为相反,于是又回来找答案。迁移路径要避免这个循环,至少包含三件事。
假设一个虚构例子:某教程教读者用一款已停产的桌面软件批量导出带时间戳的文件名,后续步骤按这个命名规则做排序。替代方案如果只写“改用命令行重命名”,读者很可能得到不同的时间格式,排序就乱了。写成迁移路径则要说明:旧工具的默认格式是“年月日-时分秒”,替代命令需要显式指定同样的格式串,验证方式是先导出三个文件,检查排序结果是否与教程截图一致。这个例子里所有名称和格式都是假设,用来演示比较方法,不代表任何真实工具的行为。
有一种反例会推翻前面的结论:当教程的核心价值恰恰来自那个停产产品的独有行为时,保留原理、换掉工具会掏空教程。
判断信号是:读者跟着教程走,真正想学的是这个产品特有的处理方式,而不是通用流程。比如教程标题和开头都在强调某个只有该产品才有的输出特性,替代工具无论怎么配置都只能近似。这时硬换工具,读者照着做出来的结果和教程示例对不上,教程的可信度反而下降。
遇到这种情况,更稳妥的处理是调整教程定位:要么明确写成“基于旧版本的记录”,把适用条件写在开头,让读者自己判断是否继续;要么把教程重构成“从旧方案迁移到新方案”的对照文档,承认差异,而不是假装差异不存在。代价是教程不再适合零基础读者直接照做,但至少不会让人做到一半才发现走不通。
不要一上来就重写全文。先做一次断链检查:把教程从头到尾读一遍,在每个出现停产产品的位置标记它是否影响后续步骤。标记完成后,你会得到一张清单,上面只有少数几个位置真正需要迁移路径,其余位置只需要一句条件说明。
这个动作的结果直接决定下一步:如果标记出的必经节点超过三处,说明教程的骨架依赖旧产品,值得整体重构;如果只有一两处,逐段补写迁移路径更省力,也不会破坏原有结构。无论哪种情况,都先写验证信号,再写替代动作,因为验证信号决定了替代动作要精确到什么程度。