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
- Learning By Writingcold-takes.com
- Cognitive load is what mattersminds.md
- how I think when I think about programming - alice mazalicemaz.com
- Computers can be understood - Made of Bugsblog.nelhage.com
- Explaining explaining: a quick guide on explanatory writinglucasfcosta.com
- Learning a technical subjectmuratbuffalo.blogspot.com
- Get better at programming by learning how things workjvns.ca
- Some thoughts on writingdanluu.com
- Essays on programming I think about a lot | benkuhn.netbenkuhn.net
- A half-hour to learn Rustfasterthanli.me
- The Surprising Power of Documentationnews.ycombinator.com
- programming practices - How to comprehend abstraction in code? - Software Engineering Stack Exchangesoftwareengineering.stackexchange.com