On being blinded by our own expertise: I looked at two different books in English on how to do Chinese calligraphy. One said the technique for the dots was “self-explanatory.” The other spent three pages on how to dot just right. You can guess which one helped me actually get my dots looking more like the model characters

@0xabad1dea "If you think that part is self-explanatory, then document it thoroughly" sounds like a good rule of thumb for documentation in general.

@0xabad1dea Clearly, the first one... by leading as example on how to not do it and making you look for another one.

@buherator @0xabad1dea BRB, going to put this in some hallways at work...