把同一篇页面拆成“新手能走通、专业人员能核对”的两层,比写给谁更关键。判断依据是:新手需要先建立可执行的整体路径,专业人员需要看到条件、边界和例外。若两者混在一起,常见结果是新手被细节劝退,专业人员又找不到判断依据。分层不是删减内容,而是让两类读者在不同深度上都能完成自己的任务。
两种条件对应两种选择,选错的代价不同。
判断动作很简单:假设一个新手只看前半部分,他能否独立完成一次操作;假设一个专业人员只看后半部分,他能否确认结论成立。两个答案都为“能”,分层才有效。若只有一个为“能”,说明分层位置放错了,需要把共同前提提到最前面。
多个角色对同一事实理解不同,往往不是谁对谁错,而是各自默认的前提不同。把分歧转成可核对的项目,比继续争论表述更有效。
完成这一步后,新手层只保留已确认的条件和最短路径;专业层保留条件差异和例外。下一步动作是检查新手层是否出现了只有专业人员才需要的限定语,若有,把它移到专业层或删除。
假设某页面要同时说明一项配置操作。新手需要的是:在什么状态下执行、执行后看到什么算成功。专业人员需要的是:哪些前提不满足时该操作会失效、失效时的表现与成功表现如何区分。
如果页面只写“按步骤执行即可”,新手可能在前置状态不满足时反复失败,专业人员也无法判断失败原因。分层后的写法是:新手层给出前置状态检查和成功标志;专业层列出不满足前置状态时的两种可能表现,并说明如何用同一组观察区分它们。这个例子的数字和场景均为假设,只用于说明分层方法,不代表任何具体工具的实际行为。
当两类读者的任务完全一致、只是知识背景不同时,分层反而会增加跳转成本。此时更好的做法是保持单层叙述,把术语在首次出现时用一句话解释清楚,并在段末补充适用条件。另一个例外是内容本身很短,拆分后每层都不足以独立成立,这时应优先保证完整路径,再考虑是否补充专业说明。
分层的最终检验标准不是结构好看,而是新手能独立完成一次动作,专业人员能核对结论成立的条件。若一次调整后新手层仍需要专业层才能理解,说明共同前提没有提前,下一步应把前提合并到开头而不是继续拆细。