产品停产后,教程里的替代方案不能只写“用另一款工具代替”。更稳妥的做法是:先判断教程的核心目标是否依赖停产产品的独有功能,再决定是整体迁移到同类产品,还是保留原流程、只替换其中一环。判断依据不是产品是否还能下载,而是读者照着教程做时,哪一步会卡住、卡住后有没有可核对的替代动作。
产品停产通常有两种情况,对应完全不同的写法。
一个可操作的判断动作是:把教程从头到尾走一遍,在每一步后面标注“这一步的输入来自哪里、输出给谁用”。如果停产产品只出现在某一步的中间环节,属于第一种;如果它的输出直接决定后面三步怎么做,属于第二种。
当停产产品只承担通用功能时,优先保留教程主体,在对应步骤旁加一个替换说明。替换说明要包含三样东西:替代工具需要满足的能力、操作结果的核对方式、以及结果不一致时的退路。
假设一个教程教读者把手机录屏转成适合上传的格式,原工具已停产。替换说明可以这样组织:
这样写的好处是读者能自己核对,而不是只能相信“这个也能用”。做完核对后,如果发现新工具在某一项上始终达不到要求,就说明这一步不该只做替换,而要按第二种情况处理。
当停产产品的输出是后续步骤的输入时,替换工具只是表面动作,真正要改的是数据怎么交出去。写法上应先说明旧流程的依赖点,再给出新流程的衔接方式。
例如教程原本依赖某停产应用生成带特定字段的清单文件,后续步骤要读取这些字段。替代方案不能只写“换成表格软件”,而要写清楚:
这里的关键动作是把“工具替换”改成“接口替换”。做完这一步后,下一步是检查教程中所有引用旧输出的位置是否都已更新;如果还有遗漏,读者会在后续步骤中遇到无法解释的报错或空白结果。
产品停产后,写教程的人、维护教程的人和实际照做的读者,对“替代方案是否成立”常有不同理解。写作者觉得功能差不多,维护者担心后续失效,读者只关心能不能走通。与其在文中争论,不如把分歧转成一张核对项。
核对项可以按角色拆分:
如果三方对同一项给出不同结论,就以读者能否复现结果为最终依据。复现失败时,先检查是工具差异还是步骤遗漏,再决定是补一句说明还是重写整段。这个动作的结果会直接影响下一步:能复现就保留替换说明,不能复现就回到流程绑定那条路径重写。
有些教程为了省事,会写“如果还能找到旧版本,可以继续按原步骤操作”。这种做法在两种情况下不成立:一是旧版本依赖的账号、接口或系统权限已经变化,读者即使装上也无法完成;二是旧版本存在安全或兼容问题,继续引导操作会把风险转给读者。
遇到这类例外,正确做法是把旧步骤标记为不再适用,并给出一个最小可用的替代路径,哪怕这个路径比原来多一步。替代路径要写清楚起点和终点:从哪一步开始改、改完后应该看到什么结果。如果暂时没有可靠替代,就明确写出“这一步目前没有稳定替代方案”,而不是用模糊说法让读者自行猜测。
最后,替代方案写完后要做一次反向检查:把教程标题和开头承诺的结果,与替代后的实际步骤对照。如果标题承诺的是“三步完成”,而替代后需要五步,就要在开头说明步骤变化,避免读者按旧预期中途放弃。