先给结论:不要试图用同一段正文同时满足两类读者,而是保留一套共享的事实骨架,把解释深度拆成可跳转的层级。新手需要能独立走完第一步,专业人员需要能快速跳过基础、直接核对边界条件和取舍依据。分层失败通常不是因为写得不够多,而是因为把两类读者的前置知识混在同一段里。
两类读者真正重叠的部分,是事实、定义边界和结果判断标准。这部分应当保留在同一页面,且写得足够短,让专业人员不必滚动太久,也让新手不至于一开始就掉进术语。
可以这样检验:把一段话里的形容词和程度词全部删掉,剩下的句子如果仍然成立,它就是骨架;如果删完什么都不剩,它只是情绪铺垫,可以移出主路径。例如“这个设置通常更快”删掉“通常更快”后没有信息,应改写成可核对的条件,比如“当请求需要跨区读取时,这个设置会改变读取位置”。
保留骨架的动作会直接影响下一步:骨架稳定后,你才知道哪些段落可以折叠、哪些必须前置,而不是凭感觉把内容切成上下两半。
当同一主题同时服务两类人时,优先改写现有段落,而不是另起一篇。改写的方式是:第一层只回答“是什么、会影响什么”,第二层回答“为什么这样取舍、什么条件下会失效”。
假设一个例子:某页面解释缓存过期时间。新手层可以写“过期时间到了,内容会重新获取”;专业层再补“如果上游更新频繁而读取延迟敏感,过短会增加回源,过长会读到旧内容”。这里的数字只是说明比较方法,不是推荐值。
这样改写的适用前提是:两类读者面对的是同一个对象,只是深度不同。如果新手关心的是“要不要用”,专业人员关心的是“在集群里怎么配”,那它们已经不是同一层问题,继续塞进一页只会让两边都找不到答案。
出现下面任一情况时,保留单页分层就不再划算,应考虑拆成两个入口,并用同一套术语互相链接:
拆分的代价是维护两处内容,收益是每类读者都能在首屏得到可执行的下一步。判断依据不是字数,而是两类读者是否会在同一个段落里产生相反的行动指令。
发布前做一次“跳读测试”:只读每个小标题和每段第一句,看能否还原出完整操作路径;再只读每段最后一句,看能否还原出取舍理由。如果前者失败,说明新手层被埋得太深;如果后者失败,说明专业层只剩结论没有条件。
这个动作的结果会直接决定下一步:跳读能还原路径,就保留单页分层;只能还原其中一层,就先改写段落顺序;两层都还原不了,再考虑拆分入口。分层不是把内容变长,而是让不同前置知识的人都能找到自己的起点。