Documentation Considered (Increasingly) Harmful
samuelalbanie.substack.com
samuelalbanie.substack.com
Also, there's a lot more to good documentation than just explaining what the code does.
Thanks for engaging. I think there's something particular about documentation & its role as a cache that makes it particularly amenable to replacement. Documentation often gets out of sync, reflects outdated assumptions, etc.
Of course, we are not there yet. The models still make mistakes.
I infer you didn't like the article, but thanks for reading and engaging.