答案不是把同一篇稿子写得“既浅又深”,而是先决定这篇内容由谁承担解释成本:如果新手必须能独立走完第一步,就把基础动作拆成可照着做的检查项;如果专业人员才是主要决策者,就把基础压缩成前提,把篇幅让给边界条件与取舍依据。判断依据是你手里的资料页现在让哪一类读者停下来提问。
关键前提发生变化,通常有两种表现。第一种是读者构成变了:原来只给内部专业人员看的说明,现在要发给刚接触业务的新手。第二种是交付目标变了:原来只求新手看懂,现在还要让专业人员据此做判断。两种情况不能套用同一种分层方法。
区分方法很直接:翻出最近收到的反馈或追问记录,看问题集中在哪里。如果问题集中在“这一步具体点哪里、填什么”,说明缺的是操作层内容;如果问题集中在“为什么这里要这样处理、什么情况下不适用”,说明缺的是判断层内容。同一篇稿子里,这两类问题往往同时存在,但处理顺序不同。
假设一份产品配置说明,新手会问“先填哪一项”,专业人员会问“这项配置在什么条件下会失效”。前者需要顺序和示例,后者需要条件和反例。这两种需求都成立,但硬塞进同一段会互相干扰:新手被条件分支绕晕,专业人员被基础步骤拖慢。
不要直接写“新手版”和“专业版”两份稿子,那样维护成本高,而且两边容易互相矛盾。更实用的做法是把同一份资料拆成三层,每层承担不同任务。
第一层是前提层。用几句话交代这篇内容假定读者已经知道什么、手上已经有什么。前提层的作用不是教学,而是让走错门的人尽快离开。比如写明“以下步骤假定账号已完成初始设置”,新手如果没做这一步,就知道该先去找哪篇内容,而不是硬读下去。
第二层是操作层。按实际执行顺序列出动作,每一步写清楚输入、动作和可观察的结果。操作层要能单独成立:新手只看这一层也能走完主流程。这里不需要解释所有原理,但每个动作后面要留一个“如果结果不是这样”的出口。
第三层是判断层。集中处理例外、取舍和边界条件。专业人员主要看这一层,所以它要写清楚:什么条件下默认做法不适用,替代方案是什么,代价在哪里。判断层不重复操作步骤,只引用步骤编号或动作名称。
三层的顺序可以调整。面向新手为主的页面,前提层和操作层在前,判断层折叠或后置;面向专业人员为主的页面,前提层简短,判断层提前,操作细节压缩成清单。
分层写完不等于分对了。可以做一个具体动作:找一位目标读者,让他只读操作层,完成一次主流程,过程中不许提问。观察他在哪一步停下来。
如果他在某个动作上反复确认,说明那一层缺了可观察的结果描述,需要补的是“做完之后应该看到什么”,而不是加更多原理。如果他一路做完但说不清为什么这样做,说明判断层没有和操作层建立对应关系,需要在判断层里点名引用具体步骤。
这个动作的结果会直接影响下一步:操作层能独立走通,就把判断层作为进阶内容单独维护;操作层走不通,就先别扩充判断层,否则只是把基础缺口藏到更长的文章后面。专业人员读不下去,往往不是内容太浅,而是判断层被操作细节冲散了。
面对新手与专业人员混在一起的情况,通常只有两个方向可选,但成立条件不一样。
判断用哪个,可以看一个信号:现有内容里,基础解释和条件判断是否频繁交替出现。交替越频繁,越适合拆开;如果基础解释只集中在开头一小段,后面全是判断,那么在一篇里分层更省事。
分层不是把内容切碎就结束。完成后至少检查三点。
如果检查时发现某层内容明显撑不起来,比如判断层只有一句“视情况而定”,那说明这篇内容目前还不具备同时服务两类读者的条件。此时更稳妥的处理是先服务好一类读者,把另一类需求记录为后续补充方向,而不是用模糊表述把缺口盖住。