产品停产后,教程里的替代方案不能只写“换一个同类工具”。用户卡住的原因通常不是没有替代品,而是替代步骤与原文操作对不上。处理顺序是:先找出原文中依赖停产产品的动作,再为每个动作写明可替换的输入、输出和检查点,最后用一个最小示例验证整条教程是否还能走通。这样改完,读者才能判断自己该继续用旧教程的哪一段,还是直接跳到新步骤。
不要从标题或产品名开始改。把教程复制到一个可编辑文档里,逐段标记以下三类内容:
标记完成后,把只出现产品名但不影响操作步骤的句子删掉。例如“打开某工具”如果没有后续动作依赖,就不必保留。剩下的动作才是替代方案要覆盖的范围。
这个动作会直接影响下一步:如果输出动作无法用其他方式复现,教程就不适合只改工具名,而应改成“用通用格式完成同一目标”的新流程。
替代方案的可执行性来自结果可验证,而不是工具名称看起来相似。对每个被标记的动作,按下面三列写:
如果某个动作找不到可验证结果,说明替代方案还停留在概念层。此时应缩小教程范围,只保留能验证的部分,而不是用模糊表述掩盖断点。
假设一篇教程原文要求:从停产工具导出一份 CSV,再上传到网站后台生成页面。停产工具已经无法导出,但读者手里仍有一份旧 CSV。替代方案可以这样写:
这个例子的重点不是 CSV 本身,而是把“替代”落到一个可重复的检查循环。读者每完成一次上传,都能根据返回结果决定下一步是改列名、改编码,还是放弃这条路径。
改完替代步骤后,用两个条件判断教程结构:
判断依据不是教程长短,而是读者是否需要同时理解两套操作。如果替代方案要求读者先理解旧流程再转换,拆开更省事;如果替代方案只是换一个保存格式,保留旧教程并补一段说明更合适。
把改好的页面从头到尾操作一遍,只记录卡住的位置。每个卡住的位置都对应一个缺失条件:可能是文件编码、字段名、权限,也可能是替代工具本身不支持某个格式。把这些条件补进正文,而不是写在文末备注里。
复查完成后,如果仍有动作无法用现有条件完成,就把该动作从教程中移除,并明确写出“这一步需要另行准备什么”。这比保留一个看似完整但走不通的步骤更有用。最终判断标准很简单:读者拿到你写的替代方案后,能否在不安装停产产品的情况下,独立走完教程并得到可检查的结果。