Patterns in confusing explanations

https://jvns.ca/blog/confusing-explanations/

作者总结了各种容易让人非常困惑的解释我的模式。学习这些模式,一方面可以避免让自己沉浸本身就让人困惑的解释其中,另外一方面在向别人解释的时候可以避免这些问题。

  1. pattern 1: making outdated assumptions about the audience’s knowledge 对读者的认知做出过时的假设,或者是写作时候的背景和现在阅读时候的背景有很大的变化,那么最好针对背景做些解释。
  2. pattern 2: having inconsistent expectations of the reader’s knowledge 对读者的预期不一致:写给编程初学者的书,却认为递归是非常自然的东西。
  3. pattern 3: strained analogies 牵强附会的比喻。通常比喻只能在某个点上做到近似,并且过多的比喻会造成失真,所以使用比喻可以但是不太太多。
  4. pattern 4: fun illustrations on dry explanations 对枯燥的解释使用有趣的示例:我理解作者不是说不可以,但是过多的有趣示例容易让读者的注意力从原来的知识上挪开。不要为了有趣而有趣, 示例的目的还是为了解释事物。
  5. pattern 5: unrealistic examples 使用不太现实的例子说明,读者通常会觉得非常别扭,而且需要花许多精力把理论映射到现实中。
  6. pattern 6: jargon that doesn’t mean anything 不要使用黑话,黑话只是为了方便交流,并没有对事物做任何解释。
  7. pattern 7: missing key information 缺少关键信息,只缘身在此山中。
  8. pattern 8: introducing too many concepts at a time 一次引入太多概念,熟悉+意外才是最好的搭配。
  9. pattern 9: starting out abstract 从具体的例子开始进行说明,而不是一开始上来就说抽象的东西。
  10. pattern 10: unsupported statements 没有说服力的表述,没有办法说服读者(或者说让读者印象深刻,缺乏逻辑性)
  11. pattern 11: no examples 不使用例子
  12. pattern 12: explaining the “wrong” way to do something without saying it’s wrong 使用错误的例子却忘记强调这个是错误的。如果读者忽略某些部分的话,很容易认为错误的例子是正确的。
  13. pattern 13: “what” without “why” 填鸭式的表述,而不给出任何解释。