Patterns in confusing explanations
jvns.ca · 4,230 words · saved by 1 readers
Patterns in confusing explanations
Hello! Recently I've been thinking about why I explain things the way I do. The usual way I write is: Try to learn a topic Read a bunch of explanations that I find confusing Eventually understand the topic Write an explanation that makes sense to me, to help others So why do I find all these explanations so confusing? I decided to try and find out! I came up with a list of 13 patterns that make explanations hard for me to understand. For each pattern I'll also explain what I like to do instead to avoid the issue. these patterns are very normal This list isn't meant to make you feel bad about y
related reading
- Precision In Technical Discussionsrtpg.co
- Explaining explaining: a quick guide on explanatory writinglucasfcosta.com
- Guessing the Teacher's Password — LessWronglesswrong.com
- Nonfiction Writing Advice | Slate Star Codexslatestarcodex.com
- Essays on programming I think about a lot | benkuhn.netbenkuhn.net
- Cocktail party ideasdanluu.com
- how I think when I think about programming - alice mazalicemaz.com
- In defense of blub studies | benkuhn.netbenkuhn.net
- Get better at programming by learning how things workjvns.ca
- Bad Explanationstalhaashraf.com
- Three Sins of Authors in Computer Science and Mathcs.cmu.edu
- Long Distance Thinkingsimonsarris.substack.com