当一篇文章的核心操作步骤依赖某个你无法控制的前提——比如后台入口已改版、第三方工具已停用、某项权限拿不到——继续照原步骤写只会让读者卡死。替代路径的正确写法是:把“无法执行”本身变成文章的一部分,先给出可判定的前提信号,再按信号分流到两套不同做法,而不是用一句“视情况而定”糊过去。
写替代路径之前,作者要分清三种“执行不了”:
只有第一种必须补替代路径;第二种应写成前置条件说明;第三种应回到上一步补检查点。判断方法是问一句:换一个完全按步骤操作的人来,他能不能走通?如果答案是否定的,就是前提问题。
替代路径不能靠作者猜,要写成读者自己能判断的条件。假设某篇文章教读者在站点后台批量修改页面标题,但后台已不再提供批量编辑入口(此为假设情形,用于说明写法)。可以这样组织:
这样写的好处是:读者不需要判断“我的情况算不算特殊”,只需要对照信号选路径。信号必须是可观察的现象,而不是“如果你的网站比较大”这类模糊描述。
替代路径最容易写虚的地方,是只给方向不给动作。可执行的最小单位是:读者做完这个动作后,能拿到一个明确结果,并据此决定下一步。
例如上文B路径中,“导出页面清单”就是一个可验证动作:导出后读者应得到一份包含页面地址和现有标题的文件。如果导出失败或字段缺失,说明这条替代路径本身也有前提,需要再退一步——改为手动记录前若干条,先处理优先级最高的页面,而不是一次性铺开。
这个动作的结果直接决定下一步:导出成功就按对照表批量回填;导出失败就先缩小范围手动处理,并把这批页面单独标记,等条件具备再补齐。文章里把这条因果写清楚,读者才不会在替代路径里再次卡住。
替代路径不是把原来的文章重写一遍。以下内容应当排除:
如果两条路径确实有取舍,就直接写取舍条件:A路径一次处理量大但依赖入口可用;B路径不依赖入口但耗时更长,适合页面数量有限、且能接受分批处理的情况。取舍条件写出来,读者才能自己选,而不是被作者替他选。
拿到一篇已有文章,按这个顺序检查并改动:
完成这五步后,文章面对前提变化时就不再是一份会过期的步骤单,而是一份读者能自己判断、自己分流的处理方案;前提一旦改变,读者仍能从文章里找到下一步该做什么。