分层不是把同一篇内容拆成“浅版”和“深版”两个页面,而是让同一页面先完成新手能独立走通的任务,再让专业人员在同一页面里找到可验证的细节。判断依据是:新手能否在不理解专业术语的情况下做出第一个动作,专业人员能否在不看入门解释的情况下核对条件、边界和例外。两者都满足,分层才成立;只满足一头,页面就会在规模化后出现例外。
假设你手里有一个介绍“批量修改商品分类”的帮助页面。新手需要知道从哪里进入、一次能改多少、改错了怎么办;专业人员需要知道分类层级变化会不会影响已有链接、接口返回什么状态、有没有并发限制。把页面里所有句子按“动作前提”和“判断条件”两类标出来,你会看到大部分冲突来自把两者混在同一段。
一个可执行的动作是:把页面按“先做一次”和“再核对一次”切成两块。前一块只保留完成一次操作所需的最少步骤,后一块集中写条件、限制和例外。做完这个动作后,下一步不是继续加字,而是检查新手块里是否还残留只有专业人员才需要判断的术语;如果有,就把它移到后一块,并在原位置留一句指向后一块的短说明。
新手层成立的条件是:读者不需要先理解分类体系、权限模型或接口字段,就能完成一次可回退的操作。写法上,第一步应当是一个具体动作,例如“在列表页勾选不超过一页的商品,再点批量修改”。紧接着说明这个动作的结果会出现在哪里,以及出现异常时先检查什么。
这里有一个容易越界的做法:为了照顾新手而删掉所有限制。限制被删掉后,新手第一次操作可能成功,第二次遇到跨页选择就会失败,反而制造更多疑问。更稳妥的处理是保留一条最小限制,并说明它为什么存在。例如“跨页选择不会保留,因为翻页后勾选状态会重置”,这句话既服务新手,也为后面的专业说明留出接口。
专业层不是把新手层的内容换更长的句子重写,而是补上可核对的信息。可核对意味着读者能拿它去验证:某个限制在什么条件下不生效,某个返回值在什么情况下出现,某个批量操作的上限是否随账户类型变化。写法上,先给条件,再给结果,最后给一个可观察的证据。
假设页面写“批量修改最多支持五百条”。这句话对新手够用,对专业人员不够,因为缺少条件:是单次请求上限,还是单页展示上限;是前端限制,还是服务端限制;超过之后是部分成功还是全部拒绝。把这些条件补在同一段落里,专业人员才能判断自己的场景是否落在例外中。补完之后,新手层不需要重复这些条件,只需要保留一句“超过上限时的处理见下方核对部分”。
个别样本成立、规模化后出现例外,通常有三个可区分的原因。第一,样本页面的结构恰好简单,没有跨页、跨权限或跨状态的组合;第二,样本页面的读者恰好是同一类人,没有同时出现新手和专业人员;第三,样本页面的限制恰好没有被触发,所以看起来不需要例外说明。检查时不要只看页面是否变长,而要看新增的例外是否改变了原有动作的成立条件。
一个可操作的办法是:从现有页面中挑出三个最常被追问的操作,分别写出“新手第一次做会卡在哪”和“专业人员会追问哪个条件”。如果同一个位置同时出现两种卡点,就把该位置拆成动作句和条件句;如果两种卡点出现在不同位置,就保留在同一页面,用短标题隔开。这个动作的结果会直接影响下一步:拆开后仍然反复被追问的位置,说明缺少的是证据而不是解释,需要补充可观察的结果或状态说明,而不是继续增加形容词。
假设有一个页面介绍“导出订单报表”。新手层写成:选择日期范围,点导出,等待文件生成。专业层写成:日期范围按订单创建时间还是支付时间计算;导出上限是否包含已取消订单;文件生成失败时返回什么状态。这个例子是假设的,只用于说明比较方法,不代表任何真实平台。
验证时,让一个不熟悉该功能的人只看新手层,能否完成一次导出;再让一个熟悉该功能的人只看专业层,能否判断自己的日期范围是否落在例外中。如果前者能完成、后者能判断,分层就达到了目的。如果前者完成不了,说明新手层还缺动作前提;如果后者判断不了,说明专业层还缺条件或证据。此时不要回头增加关键词或重复同义句,而应回到对应层补一个具体条件。