好的文字解释有什么特点？

本文我专注于文字解释，所以我会忽略间隔重复卡片、可视化之类的手段。

• 确立读者所需的前置知识，介绍背景信息，之后以此为基础进一步阐述
  
  
• 模拟读者缺乏经验的心境
  
  
• 预计有哪些常见的误解或错误观念，并一一处理
  
  
• 预计读者会问哪些常见的问题
  
  
• 不要假设读者的工作记忆是无限的（这里说明了如果违反这条规则会有什么后果：解释材料中假设了工作记忆容量是无限的^[1]）
  
  
• 如果文中有指代相同概念的不同词汇/术语/短语，要明确说明（即使是技术领域，同义词也非常常见！）
  
  
• 指出哪些东西不是很重要，初学者不用关心，让读者集中注意力
  
  
• 如果同一个词汇/术语/短语指代了不同概念，也要说明（这个现象即使是在技术领域也非常常见！）
  
  
• 定义概念时要给全四种例子
  
  
• 对抗混淆：相连介绍看起来相似的概念时，停下来要说明这两个概念是否真的相似
  
  
• 告示读者有一些概念会过时，因为后续会进一步阐述
  
  
• 考虑概念的各种组合情况（参见遍历组合技巧，这是更相近的想法）——其实人们写作时会隐式地画一个表格，一列一个属性，一行一个例子，然后把一些单元格填满，但有些单元格没有填；举例说明这个想法不成立的地方：https://github.com/riceissa/project-ideas/issues/18
  
  
• 在具体和抽象之间交替解释
  
  
• 从头到尾都要提供很多例子
  
  
• 给出一个精确/技术性/可操控的模型以便读者摆弄
  
  
• 措辞要保证让读者读得懂（你措辞模糊，可能指代很多东西，或者用词抽象，读者不知道能联系到什么具体东西，读者就看不懂了；）
  
  
• 引入参数和变量时，要说明常见的值，也要说明极端的值
  
  
• 给出高质量的心理表征
  
  
• 比如给出数学概念的定义时也要说明人们在应用时心里是怎么想的
  
  
• 按照概念发现故事^[2]的结构设计
  
  
• 开头给出学习该领域的动机，回答「那又如何」——换句话说，如果有人因为话题看起来似乎有点酷，或者所有人都在讨论，而阅读你这篇文章，看到动机一节时，他们应该会非常感兴趣；你描述的动机，应该能增强读者初始的动机。不要写那种大多数文章里面一点即灭的动机，说什么「这个学科很重要」。这里就要问：什么样的动机是好动机？^[3]甚至很多偏向教学的数学解释材料都会遇到这个问题；虚假动机^[4]。
  
  
• 每个步骤都要说明动机
  
  
• 不仅要说明关键的洞见，而且要说明可用于发现这些洞见的通用方法
  
  
• 说明这个话题下容易想到但是失败了的方法/行不通的办法
  
  
• 定义压轴^[5]放最后
  
  
• 提问方法
  
  
• 请读者在阅读解决方案之前先自己思考一下。但这需要谨慎行事，以提高读者的兴趣，而不是吓唬他们。有关详情，请参阅管理学习中的微动作^[6]。

参见

• 解释学^[7]

外部链接

• https://issarice.com/math-explanations
  
• https://machinelearning.subwiki.org/wiki/User:IssaRice/Mental_representations_in_mathematics
  
• https://jvns.ca/blog/confusing-explanations/ https://news.ycombinator.com/item?id=28254630
  
• 这个页面上的视频也讨论了一些提升解释文章质量的方法：https://www.3blue1brown.com/blog/some1
  
• 评判教科书^[8] by https://captchasamurai.github.io/homepage/index.html
  

链接到本文

• 解释材料中假设了工作记忆容量是无限的^[1] ‎ (← 链接)
  
• 我们仍然不知道系统性撰写优质文字解释的方法^[9] (← 链接)

Thoughts Memo 汉化组译制
感谢主要译者 Shom
原文：What makes a word explanation good?

← 返回目录