结论先行:如果停产产品的替代方案在功能、接口或使用路径上不能与旧型号一一对应,教程就不应把替代品写成“直接替换”,而应改成带前提的迁移说明;只有当新旧方案在关键约束上确实一致时,才适合保留原来的操作步骤并只替换名称。下面给出判断条件、一个会让结论失效的反例,以及可执行的处理顺序。
产品停产后,旧教程面对两类读者:已经持有旧产品的人,和准备购买替代品的人。前者需要维护、排错和兼容说明,后者需要迁移路径。把两类需求塞进同一篇教程,通常会让步骤互相冲突。
可以用三个条件决定是否保留原页面:
三个条件都满足时,保留原教程并增加替代说明即可。任一条件不满足,就应拆分页面,而不是在同一标题下混写。
只写“可用某产品替代”没有决策价值。读者需要知道差异出现在哪一步,以及差异会不会让后续操作失效。
可用的替代说明至少包含四类信息:
假设旧教程要求用某型号传感器接入控制器,替代传感器输出信号范围不同。此时不应只改产品名,而应增加校准步骤,并说明未校准会出现什么读数偏差。这个动作会让后续阈值设置失去原有参考,因此下一步必须重新标定,而不是沿用旧参数。
如果替代品只在外观和安装方式上接近,但固件配置、供电要求或数据格式不同,“直接替换”的写法就会误导读者。更隐蔽的情况是:替代品能完成同一任务,却需要额外账号、订阅或中间设备。
这类反例的判断信号不是“能不能装上”,而是“装上之后,旧教程的下一步是否仍然成立”。只要后续步骤需要重新配置、重新授权或重新校准,替代方案就应写成迁移教程,并在开头说明旧步骤的适用范围。反过来,如果替代品在接口、协议和操作路径上完全一致,只是型号变化,那么保留原步骤并加一行替代说明更合适,拆成新文章反而增加维护成本。
先确认旧页面当前服务的是维护需求还是购买需求,再决定保留、改写还是新建。若旧产品仍有维护价值,保留原教程,在显著位置标注停产状态和替代关系;若替代品改变了关键步骤,新建迁移教程,并从旧教程链接过去,避免两套步骤互相污染。
接着检查标题和开头承诺是否仍与正文一致。标题写旧型号,正文却以替代品步骤为主,读者会在第一步就失去判断依据。最后,用一次实际迁移验证替代说明:按新步骤操作,记录在哪一步需要额外动作、哪一步旧参数不再适用。验证结果决定下一步是补充差异说明,还是把替代方案独立成篇。这个顺序能避免把停产变化写成简单换名,也能让维护型读者和迁移型读者各自找到可用路径。