直接回答:把“替代方案”写成条件分支,而不是推荐清单。对每个停产件,先写清它原本承担的功能和约束,再分别给出“可原位替换”“需改配套”“只能改设计”三类路径,并标注每类路径的验证动作。读者照做时能判断自己该停在哪一步,而不是照搬某个样本。
同样是产品停产,教程的写法差别很大。先确认停产件在原教程里扮演什么角色:
这三类的边界不能混用。一个读者拿到的资料可能同时涉及功能件和结构件,如果教程只给单一替代型号,规模化后必然出现例外。处理办法是把每类分开成段,每段末尾写一句“若你的设备属于另一种情形,跳到下一节”。
不要急着写“可以用某某代替”。先为停产件建三张卡,这是后续所有替代路径的依据。
写它输入什么、输出什么、在什么条件下必须成立。例如一个停产的控制模块,输入是传感器信号,输出是开关动作,条件是环境温度在一个范围内。
写引脚、螺纹、法兰、通信协议这类物理或协议连接点。接口不匹配时,替代品即使功能相同也不能直接装。
写供电、散热、空间、认证或配套软件版本。约束是规模化后最容易出例外的地方:单个样本能跑,批量装配时空间或散热不够。
三张卡写完后,替代方案自然分成“功能可替、接口可替、约束可替”三个判断层。读者可以先查自己卡在哪一层,再决定是否继续往下读。
假设一个教程原本使用某停产传感器,现在要写替代方案。可以按下面的结构组织,每一步都带验证动作:
这个顺序的意义在于:读者每完成一个验证动作,就知道下一步该做什么。如果第一步验证失败,说明不能走原位替换,必须进入改配套路径,而不是继续找同型号。
样本成立不等于规模化成立。以下边界要在页面上明确写出,而不是留给读者猜:
一个实际动作是:在替代方案段落末尾加一行“适用条件”,写明该方案在什么数量、什么环境、什么版本下被验证过。读者看到这行,就能判断自己的场景是否落在边界内。落在边界外的读者会主动去找改设计路径,而不是照搬后失败再回头。
替代方案写完后,还要回答一个问题:原教程的哪些步骤需要改。做法是把替代路径映射回原步骤编号,标注“保留”“替换”“新增”三种状态。保留的步骤不动,替换的步骤给出新动作,新增的步骤说明插入位置。
这一步的结果直接影响下一步:如果替代路径导致超过一半步骤需要改动,说明原教程已经不适合作为该产品的操作依据,应该另起一篇新教程,而不是在旧页面上打补丁。反之,如果只有个别步骤替换,旧页面仍可作为主入口,替代方案作为附加段落存在。读者据此能判断自己手上的资料是继续用还是重写,而不是在两种状态之间反复摇摆。