That's a really neat theory about documentation aversion. Reading your 
explanation, I got a hunch that maybe it's because considering others 
emotionally is built-in, while considering others cerebrally is rather hard 
work that can lead to overthinking and other problems so people throw in the 
towel.

There seems to be broad agreement that good docs contain tutorials, how-to 
guides, and a reference. I've never heard about explanation mentioned 
separately but it makes total sense- [I'll add 
it](https://github.com/nim-lang/Nim/issues/22720) . Your rationale for having 
tutorials sums it up nicely, adding that as well. 

Reply via email to