结论先行:只有当新手与专业人员带着不同的任务来到同一页面时,分层才值得做;如果两类读者只是知识水平不同、目标却一致,强行分层反而会把一个完整答案拆散。可行的分层不是“先写浅的再写深的”,而是让新手能安全开始、让专业人员能快速核对依据,两条路径共用同一套事实。
两类读者对同一事实理解不同,通常有两种原因。一种是知识差距:新手不知道某个术语的含义,专业人员知道。另一种是任务差距:新手要判断“我该不该做这件事”,专业人员要判断“按什么条件做、做到什么程度算完成”。前者靠解释术语就能解决,后者必须拆成两段不同的内容。
可核对的证据是提问方式。如果两类人问的是同一件事的不同深度,比如都问“这个设置要不要开”,那只是知识差距,不必分层。如果新手问“开了会不会出问题”,专业人员问“在什么前提下开、关掉后如何回退”,这就是任务差距,值得分层。把这两种情况混为一谈,是分层失败最常见的原因。
建议的结构是:先用一段不依赖前置知识的文字交代共同事实——这件事是什么、影响谁、不做什么会怎样;然后明确分叉,一条给新手,一条给专业人员。分叉点要写在页面上,而不是靠读者自己猜。
假设一个页面要说明“批量修改已有内容的标题结构”。新手需要的是:先备份、先改一页看效果、异常就停。专业人员需要的是:哪些页面不适合批量处理、如何抽样核对、改动后观察哪些信号。这两段可以放在同一页,但必须各有明确的小标题,让读者一眼知道自己该读哪段。
反例是:两类读者其实在做同一件事,只是经验不同。比如都只是想知道“这个字段填什么”。此时若硬拆成“新手版解释”和“进阶版解释”,专业人员会嫌浅层内容占地方,新手会误以为深层内容才是正确做法,结果是两边都要来回跳。这种情况下正确做法是合并成一段,用一句话给默认值,再用一个括注说明例外,而不是分层。
另一个失效信号是:分叉之后两条路径给出的事实互相矛盾。这通常不是分层的问题,而是页面本身没有确定前提。先统一事实,再决定要不要分叉。
当团队内部对同一事实说法不一时,不要靠加长文章来调和。更有效的动作是把分歧写成一张核对清单,每条都带一个可观察的结果。例如:
这个动作的结果会直接改变下一步:如果核对发现两类读者的前提其实一致,就删掉分叉;如果前提确实不同,就保留分层,并把前提写在分叉点旁边,而不是藏在文末。注意,某个信号暂时没有变化,并不能单独证明分层正确,也可能是改动尚未生效或样本太少,需要结合其他信号一起看。
分层有代价:页面变长、维护点变多、两条路径容易逐渐不同步。因此只在任务确实不同、且两类读者都会实际到达这个页面时才做。若专业人员只是偶尔路过,优先保证新手路径完整;若新手只是被引导进来了解概念,优先保证专业路径的准确性。没有适用于所有页面的字数或结构阈值,判断依据始终是读者要完成的任务,而不是篇幅。
下一步动作可以很简单:把当前页面的读者按“要做的决定”列成两行,若两行是同一个决定,就合并;若是两个决定,就在分叉处各写一句“如果你要解决的是X,读这一段”,然后删掉所有重复的解释。