先给结论:同一主题同时服务新手和专业人员时,优先判断两种读者是否在同一个决策点上。如果新手需要先建立判断框架,专业人员只需要核对细节,那么保留一个页面、把内容分成“先结论后依据”的两层通常更合适;如果两类读者要完成的任务不同,例如新手在选方案、专业人员在验收参数,继续堆在同一页只会让双方都找不到重点,此时应拆成两个入口,再用链接建立关系。改写只适合一种情况:原有内容的事实主体没错,只是解释顺序和术语密度让某一类读者提前退出。
多个角色对同一事实有不同理解,并不等于他们需要不同的页面。可核对的判断方法是把分歧写成一句话,再看这句话属于哪一类:
实际动作:把两三类读者的原话各摘一句,去掉情绪词,只保留他们想确认的事实。若这些事实可以共用同一个结论,只是展开深度不同,就保留;若结论本身不同,就进入拆分判断。这个动作的结果会直接决定下一步是调整结构还是新建页面。
保留的前提是两类读者共享同一个核心结论。写法上不要前半段对新手、后半段对专业人员,这会让专业人员翻很久才看到依据,也会让新手误以为后半段必须读懂。
更稳妥的做法是每一节都先给可独立成立的结论,再给适用条件和核对方法。例如先写“在假设条件下,A 方案适合先验证”,再写“验证时要记录哪些输入、哪些异常会让结论失效”。新手读到第一句就能继续往下走,专业人员可以跳过解释直接看条件和记录项。
这里有一个假设例子:某页面介绍一种内容整理方法,新手想知道先做什么,专业人员想知道在哪些数据条件下这个方法不成立。若把“先做什么”和“何时不成立”写成两个小节,并让后者可以单独引用,那么同一页就能同时满足两类人。这个例子只说明比较方法,不代表任何真实项目效果。
需要避免的是机械换写。把“适合新手”改成“入门友好”、把同一段话换个同义词再放一遍,不会产生新的判断依据,只会让专业人员认为页面在重复。
改写成立的前提是原有内容没有事实错误,问题只出在进入路径。常见信号是:新手在开头就遇到未解释的术语而离开,专业人员则抱怨关键条件被埋在长段落里。此时可以保留原有事实和例子,只调整三件事:
改完后要检查一个动作:让不熟悉该主题的人只读每节第一句,是否能说出这页在回答什么;让熟悉该主题的人只读条件和核对项,是否能判断结论是否适用。若两者都能完成,改写就够了,不必新建页面。若其中一类仍然要绕路,说明任务差异没有被解决,应回到拆分。
拆分不是把一页切成两页再互相复制。它适用于以下至少一个条件成立:
拆分后的关系要用链接说明,但链接文字要写清对方页面解决什么,不要只写“了解更多”。同时要指定一个主页面承接共同结论,避免两个页面各说一套。若共同结论本身还在变化,先不要拆,否则维护成本会转移到一致性检查上。
有时两类读者的分歧不是深度问题,而是对事实本身没有共同定义。例如一方说的“完成”指流程走完,另一方指结果被验收。此时继续添加解释、案例或问答,只会让页面变长而不解决分歧。
可执行的动作是把分歧改写成核对表:谁在什么阶段、看到什么记录、由谁确认。若这张表仍然无法让双方用同一句话描述,说明当前页面不适合承担这个任务,应退出该写法,改为分别说明各自前提,或在页面中明确标注适用范围。请求量、抓取量或某项统计归零,不能单独证明这种退出是正确的,也可能是入口变化、统计口径变化或外部规则调整造成的,需要结合其他证据判断。
最后检查一次:保留、改写还是拆开,不取决于哪类读者更重要,而取决于两类读者是否共享同一个可核对结论。共享则分层保留,不共享则按任务拆开;事实不动只改路径时改写;分歧无法转成核对项时退出当前写法。