模型、规则与解释的对应
建立可识别的对象和关系,用规则说明结果,区分说明模型、实际过程和设计来由,并用条件变化检查解释边界。
解释让读者认识对象、关系和规则,并据此理解一个结果怎样成立。一个可用的模型保留当前判断需要的信息:有哪些对象,什么条件成立,对象怎样发生联系,以及可以得出哪些结果。模型可以用文字、图、表或符号表达。
本篇以构造的材料整理情境建立解释方法。它不要求读者先理解某个技术系统。具体领域的完整机制,应在相应知识对象内解释并保留实现条件。
先建立可以指认的对象
假设有两份材料卡片,记录名称、取得日期和内容;作者希望把同一份材料的不同记录归并。读者首先需要认识“材料”“记录”和“归并结果”:材料是被记录的对象,一份材料可以产生多条记录,归并结果将符合判定条件的记录放到同一组。
名称相同不足以确定对象相同。两个不同作者可能使用同一标题;同一份材料也可能在不同地方使用别名。解释归并规则时,需要明确它使用哪些身份依据,怎样处理信息不足,以及无法确认的记录会怎样保留。
对象、记录与名称取得指向以后,再使用“身份”“判定条件”等术语。先堆出这些术语,仍可能遗漏读者需要的联系。
规则把条件接到结果
下面给出一个纯教学模型:两条记录具有相同的已核对材料标识时归为同一组;标识不同则分别保存;缺少标识时暂不归并。这里的标识是预先假定能够指认材料的符号,没有声称现实中存在统一可靠的标识规则。
| 记录对 | 输入条件 | 规则结果 |
|---|---|---|
| A与B | 标识均为M1,已确认标识对应同一材料 | 同组保存,保留各记录的日期和内容 |
| A与C | 标识分别为M1和M2 | 分组保存 |
| A与D | D缺少标识,名称与A相同 | 暂不归并,记录判断缺口 |
规则的结果能从输入条件取得。解释还需要区分两件事:模型怎样推导归并结果,以及用于确认身份的依据怎样取得。前者是本例的规则推演,后者需要实际材料核查。身份依据失效时,符合表格规则的处理也可能产生错误归并。
一条可核对的解释因此包含对象、条件、作用规则、中间联系和结果。需要时继续说明失败分支与代价,例如暂不归并会增加重复查找,却保留了尚未确认的区别。
需求、作用与设计来由
需求说明希望取得什么结果,约束说明允许或必须满足什么条件。构造情境中的目标是减少重复记录,同时保留不能确认的区别。暂不归并规则能够在这些假设下限制错误合并;它也留下后续核对工作。
根据规则说明它怎样支持目标,是作用解释。说明某位设计者当时为何采用规则,需要其提案、说明或决策依据。作者可以构造一个目标来显露规则的作用,但需要标明教学假设,不能据此编造真实发明过程。
解释一个局部关系时,也可以直接从现象或最小模型进入。每篇都补一段需求历史,可能引入与目标判断无关的背景。Diátaxis 将解释放在理解、联系与背景的范围内,具体主题仍需要围绕有意义的对象界定。1
条件变化显露规则边界
保留相同规则,改变决定结果的条件,可以看出模型覆盖到哪里。假设M1后来被发现误标给两份不同材料,归并结果就需要重新核对;假设D补齐可靠标识,可以重新判定;两份材料内容相似,仍不足以自动证明它们是同一对象。
变化需要针对当前结论。例子增加了颜色、卡片大小,却没有改变身份判断时,这些细节通常不帮助检验规则。需要区别同名与同一、缺信息与否定证据,才应让变化进入解释。
一个正例展示规则怎样使用,一个会改变判断的变例展示条件怎样约束结果。数量由解释需要决定。取得一次预期输出,只确认相应输入和规则的对应,推广仍需核对其他条件。
说明模型与实际过程
材料归并可以被描述为“识别对象—比较依据—取得分组”。这个顺序便于说明结果,不意味着实际人员或工具必然逐步执行三项独立动作。实际实现可能提前整理标识、并行核查或在取得新材料后增量修订。
模型保留的是输入、判定关系和结果。若文章要说明实际处理顺序、耗时或资源,则需要对应观察或实现依据。图中的箭头也应注明表示推理依赖、处理次序还是数据传递。
使用类比时,同样指出保留关系。可以把材料标识比作查找位置,帮助认识定位作用;位置正确无法单独证明内容真实,这个区别需要在影响判断时说明。
根据知识缺口选择入口
| 读者已知与缺口 | 可以采用的解释路径 |
|---|---|
| 已知结果,不能解释原因 | 展示现象,补出对象、条件和规则 |
| 已有方法无法满足目标 | 说明目标与约束,展示新增规则改变哪项关系及代价 |
| 对象陌生或定义相互依赖 | 给可指认的局部情境,再建立名称与联系 |
| 多个部分共同影响结果 | 给有限总览,沿一个完整判断建立对应,再展开局部 |
| 已能认识候选,需要选择 | 建立共同维度,按条件比较结果、代价与未知 |
这些路径可以组合。每次展开增加当前需要的关系,再对应回规则。作者的研究顺序和读者的理解顺序各自服务不同用途;按已经核对的对象关系安排正文。
概念图可以把“材料由记录描述”“记录按身份依据归并”等命题放在一起,用关系词检查解释是否连通。Novak与Cañas的方法强调焦点问题和命题关系,适合用来发现含义不清或缺失的连接。是否形成图,取决于当前表达收益,无需为此保存一份永久重复索引。2
控制解释深度
从目标判断向前追溯必要知识。要解释为什么同名记录暂不归并,需要对象身份、判定依据与信息不足;材料制作工艺和所有记录工具的操作,通常不参与该判断。
已有基础可以简要回顾,陌生且决定结果的联系要在当前成果建立。继续深入的条件是:内部细节会改变目标解释、判断或操作。省略会影响适用范围时,在相关位置说明。
完成后沿给出的输入、对象和规则检查:结果能否取得,条件变化能否解释,符号与文字是否对应,以及是否还需要作者未声明的知识。这种检查评价正文提供的支撑;真实理解收益需要相应读者和任务证据。
Footnotes
-
Daniele Procida,Diátaxis,Explanation,Explanation and its boundaries、Make connections、Provide context。作为文档理解用途与组织建议使用,未据此声明读者效果。 ↩
-
Novak、Cañas,The Theory Underlying Concept Maps and How to Construct and Use Them,IHMC Technical Report 2006-01,2008-01修订,Constructing Good Concept Maps、Focus Question。来源取得范围沿用2026-10-05的方法研究;使用其焦点问题与命题关系,没有移植全部教学安排。 ↩
最后更新于