先给结论:不要把停产型号直接替换成“新型号”就结束,而要按功能位、接口位、参数位三层逐一交代,让读者能判断替代品是否真的可用。具体做法是把原教程里的每个操作步骤拆成“依赖什么”,再为每个依赖写清替代条件、验证动作和失败后的退回方式。
打开你手上那篇停产产品的教程,逐段标出它隐含依赖的对象。通常只有三类:
这三类里,功能位最容易替代,参数位最难。判断一篇停产教程能不能继续用,就看它有多少步骤卡在参数位上。如果超过一半步骤依赖具体数值,那这篇教程更适合重写而不是打补丁。
常见错误是写“可以用某某型号代替”。读者无法验证这句话。改成条件句:
假设原教程要求 12V/2A 供电,替代模块标称 12V/1.5A。那么写“若你的负载电流不超过 1.5A,可直连;否则需外接供电,并确认共地”。这句话给了读者一个可执行的检查动作:先量负载电流,再决定接线方式。量出来的结果直接决定下一步是直连还是加电源,而不是让读者猜。
条件句的另一个好处是暴露遗漏条件。很多停产教程失效,不是因为主器件买不到,而是因为某个辅料或工具停产了。把每个“若……则……”写出来,遗漏项会自己浮出来。
不要整段替换,按步骤做对照。表格不方便时用列表,每一项包含四列信息:原步骤、依赖项、替代动作、验证方式。例如:
粒度控制在“一个动作对应一个验证”。验证失败时,读者知道该退回哪一步,而不是整篇教程作废。
有些依赖确实没有等价替代,比如专有加密芯片或已停产的校准治具。这时不要硬凑方案,而要写清绕行路径或放弃条件。例如:若校准必须依赖原厂治具,而治具已不可获得,则说明该教程的校准章节不再适用,并给出两条路:改用出厂默认参数,或送第三方校准。同时说明这两条路各自的限制,比如默认参数可能不满足高精度场景。
这一步决定了教程的可信度。读者最怕的是照着做了一半才发现关键步骤无解。提前标出死路,比给一个勉强能跑的替代方案更有用。
改完替代方案后,不要通读一遍就发布。挑原教程里最核心的一个操作,按新写法从头走一遍,记录在哪一步需要额外判断。如果额外判断超过两处,说明替代方案写得太碎,读者会在中途迷失。此时应把相关步骤合并成一个决策小节,先讲清判断依据,再讲操作。
这个动作的结果会直接影响你下一步是继续补细节,还是回头简化结构。最小复现通过,才说明替代方案达到了可执行的程度。