答案不是把同一篇内容拆成两版,而是保留一套主干解释,再用可折叠的深挖层承载专业读者需要的前提、边界和反例。判断是否分层,关键看两类读者是否会因为同一段话产生相反动作:新手照做会出错,专业人员跳过又不会损失信息。若不会,就不必分层。
常规做法通常是把术语解释一遍,再补一段“进阶说明”。但如果冲突不在术语,而在动作前提,补术语并不能解决问题。例如一篇讲批量替换站内文案的教程,新手需要知道先备份、先小范围试跑;专业人员更关心替换规则是否会误伤结构化数据、是否要保留原始字段。两类读者读到同一句“直接执行替换”时,新手可能漏掉备份,专业人员则可能认为这句话过于粗糙。
这个遗漏条件的可操作判断是:把当前段落按“谁读完会立刻动手”分成两类。若两类人动手前的检查项不同,就说明需要分层;若只是词汇熟悉度不同,改写一句话即可,不必新增层级。
保留适用于多数读者的主干,是分层最省成本的选择。主干只回答“做什么、按什么顺序做、做完看什么结果”,不展开争议。专业前提放进独立小标题或折叠块,标题直接写明适用条件,例如“仅当你有权修改模板时”。
实际动作:在主干末尾加一句指向深挖层的条件句,例如“如果你的替换范围包含动态渲染字段,先看下一节的边界说明”。结果是新手可以按主干完成一次低风险操作,专业人员则能判断自己是否属于例外。下一步不是继续扩写,而是检查深挖层是否只包含主干无法容纳的前提,避免把主干内容重复一遍。
当两类读者都需要同一结论,但专业读者需要知道结论从哪来时,改写比新增章节更合适。做法是把结论放在主干第一句,把推导、反例和失败条件放进专业层。这样新手拿到可执行结论,专业人员拿到判断依据。
假设一个场景:内容要说明“旧页面是否保留”。主干可以写“先保留,等新页面稳定后再决定是否重定向”;专业层再说明保留期间要观察哪些信号,以及哪些信号同时出现才支持退出。这里数字只用于说明比较方法,例如连续观察两个发布周期,而不是承诺某个周期一定见效。若推导部分过长,优先压缩成条件清单,而不是把主干改写成论证文。
退出分层的条件同样明确:当专业读者与新手读者的下一步动作完全一致,只是解释深度不同,分层只会增加维护成本。此时更好的做法是保留一套正文,把少数术语用一句话解释清楚,不额外设置折叠层或进阶区。
另一种退出信号是分层后主干被掏空。若主干只剩下“详见下文”,新手读完无法独立完成动作,说明分层失败。此时应把关键步骤搬回主干,把专业内容降级为注释或补充说明。结果是读者不必在两层之间来回跳转,内容也更容易被后续更新。
完成这四步后,再决定保留、改写还是退出分层。分层不是内容完整度的装饰,而是让不同读者在同一页上各自找到自己需要的下一步动作。