先给结论:不要把停产产品的旧步骤删掉重发,也不要用一句“已停产,请咨询”代替全文。正确做法是保留旧步骤作为识别参照,在每一步旁边补上“现在可用什么动作完成同一目标”,并把无法替代的环节明确标成阻断点。这样读者能判断自己手上的旧资料是否还能用,而不是读完仍然不知道下一步做什么。
拿到一篇旧教程,不要整篇重写。把它拆成三类内容:目标、动作、结果。目标通常不受停产影响,比如“让家长在开放日前完成预约”;动作往往依赖具体产品,比如某个表单工具或某套后台;结果则是动作完成后的状态。停产影响的是动作层,不是目标层。
逐段标注时问三个问题:这一步换成别的做法,目标还能达成吗?旧截图或旧界面描述会不会误导读者?有没有一步是只有原产品才能完成的?第三类问题出现的地方,就是必须写成阻断点的位置。把这三类标注做完,替代方案的范围就确定了,不需要凭感觉决定删哪段。
常见的错误写法是“原产品已停产,推荐使用某某替代”。读者真正需要的是:原来那一步在做什么,现在用哪类动作可以完成,需要准备什么。产品名可以出现,但不能成为唯一答案,否则读者一旦拿不到同一款产品,教程又失效一次。
可以按下面的顺序组织每一处替代:
这样写的好处是,读者不需要先确认你能推荐哪款产品,就能判断自己手上现有的条件能不能完成同一目标。
停产产品最容易出现的反常现象是:旧教程的操作步骤仍然能走通,但结果已经不对。比如界面还能打开、按钮还能点,导出的字段却少了,或者分享出去的链接在对方那里显示异常。这类问题不能靠“步骤是否成功”来判断,要靠结果核对。
区分两种解释时,可以设计一个最小核对动作:用同一份测试数据,按旧教程走一遍,再按替代动作走一遍,比较最终产出的字段、数量和可分享状态。如果两边结果一致,说明旧步骤可以保留为参照;如果只有旧步骤出现缺失,就不能写成“仍然可用”,而应写成“界面可操作,但产出不完整,需改用替代动作”。
这里要说明一个假设例子:假设旧教程要求把名单导出为五列,替代动作导出后只有四列,缺的是班级字段。这时不能下结论说替代方案更差,因为缺列可能来自导出模板设置,而不是动作本身不可行。下一步应先补上字段映射,再重新核对一次。只有补完仍然缺,才把这一步标成阻断点。这个判断顺序能避免把设置问题误判成方案问题。
替代方案成立与否,取决于读者手里已有什么。写教程时至少区分两种情况:学校已有统一平台,和没有统一平台只能靠通用工具。前者的替代动作应优先指向内部流程,后者的替代动作才需要描述通用做法。两种条件混在一段里,读者会误以为所有步骤都适用于自己。
阻断点要单独标出,并写清楚阻断的是什么。例如“旧产品提供的自动去重无法用现有通用工具替代,需要人工核对一次”。这句话给出了可执行动作,也给出了动作的代价,读者据此决定是接受人工核对,还是改用其他流程。不要用“建议联系相关人员”这类没有信息量的句子收尾,它既没有说明联系谁,也没有说明联系后能解决哪一步。
整篇替代方案写完后,做一次端到端核对:从读者拿到旧教程的第一步开始,按替代动作走到最后一步,检查最终产出是否与旧教程承诺的结果一致。一致的部分保留原结构,不一致的部分回到对应段落补条件或标阻断。
核对结果会直接影响下一步:如果只是个别步骤需要替换,就局部修改,不必重发整篇;如果旧教程的目标本身已经随流程变化而失效,就需要先重写目标,再补动作。判断依据是结果是否还能被读者核对,而不是页面看起来是否完整。把这一步做完,替代方案才算真正可执行,而不是把停产说明贴在旧文开头就结束。