当读者照着一篇文章操作到某一步却做不下去时,文章不该只重复原步骤,而应给出保留、改写或退出三条替代路径中的一条,并说明它成立的前提。判断依据是:这一步失败的原因是否可由读者自行控制。可控则改写,不可控则退出,介于两者之间则保留并加条件。
替代路径的选择,取决于失败原因的归属。读者侧指权限、账号类型、文件格式、本地设置等他能自行调整的因素;环境侧指平台规则变更、接口关闭、他人审核、外部数据不再公开等他无法单方面改变的因素。
一个可区分的证据是:如果换一个账号、换一台设备或换一个文件后同一步骤能走通,问题多半在读者侧;如果所有条件都换过仍然卡住,问题更可能在环境侧。这个判断决定了你该写“改写”还是“退出”。
把这一步判断写进文章,比堆一段“如果遇到问题请联系客服”更有用,因为读者拿到的是一条能自己执行的判断规则。
保留适用的前提是:原步骤本身没有错,只是读者缺少某个前置条件,而这个条件是可以补上的。例如某一步要求先完成账户验证,读者没做,于是后续操作全部不可用。
这种情况下文章应做的是把遗漏条件提到该步骤之前,而不是删掉原步骤。可以补一句判断语句,让读者自查:
保留路径的价值在于它不牺牲原有信息量。代价是文章会变长,所以只对真正高频卡点使用,不要给每一步都加前置说明。
改写适用的前提是:读者要的结果仍然可达,但原路径依赖的条件已经不具备。此时文章应给出一个目标相同、依赖更少的替代做法,并说明改写后哪一部分结果会变弱。
假设一个场景:某篇文章教读者通过页面上的导出按钮获取一份数据,但该按钮对当前账号类型不可见。改写路径可以是手动整理可见字段,代价是拿不到完整字段。文章要写清这个代价,读者才能决定值不值得走。
改写时容易犯的错是只给替代做法、不写差异。读者照做之后发现结果和预期不符,反而更困惑。因此每个改写路径都应对应一句“这样做的结果与原来差在哪里”。
退出的前提是:失败原因在环境侧,读者无法通过任何自助动作绕开。这时继续给替代做法只会浪费读者时间,正确的处理是明确说明该步骤当前不适用于哪类情况,并指出读者应该转向什么。
退出路径不是敷衍。它至少应包含三点:
退出写法最容易被写成免责声明,但读者需要的是判断依据,不是责任划分。把“什么情况下别再做这一步”写清楚,比笼统提示有用得多。
写作者可以用一个动作来确定替代路径:把自己当成第一次执行的读者,逐步复现,记录第一个无法继续的位置及其原因。如果原因是缺少可补的前置条件,写保留;如果原因可绕过但结果有损,写改写;如果原因是外部限制且无法绕过,写退出。
这个动作的结果会直接影响下一步:判定为保留时,你只需调整步骤顺序;判定为改写时,你要额外补一段结果差异说明;判定为退出时,你要删掉或弱化原步骤,并补上转向建议。三种处理对应的编辑工作量不同,先判断再动笔,比先写替代做法再回头找理由更省事。
需要提醒的是,某一步骤在你自己环境里执行失败,不能单独证明它对所有读者都不可用;同样,一次成功也不能证明它普遍成立。替代路径应写成带条件的判断,而不是绝对结论。