one day I want to write a blog post with tips for writing explanations that respect the reader, like
- if something is weird, explain whether there's a good reason it’s weird or not
- spend a lot of time on making examples feel relevant
- if there's something that seems theoretically important but that you've never actually needed, leave it out
- if something is only useful in a very limited set of situations, tell them (or leave it out!)
(none of this is easy obviously)