Documentation Considered (Increasingly) Harmful samuelalbanie.substack.com 3 points by albanie 16 hours ago
MountainMan1312 16 hours ago Just another "AI is here so why bother" argument.Also, there's a lot more to good documentation than just explaining what the code does. albanie 13 hours ago Author here.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.
albanie 13 hours ago Author here.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.
al2o3cr 16 hours ago Of course, we are not there yet. The models still make mistakes. Biggest mistake was publishing this fact-free hype-slop. albanie 13 hours ago Author here.I infer you didn't like the article, but thanks for reading and engaging.
albanie 13 hours ago Author here.I infer you didn't like the article, but thanks for reading and engaging.
Just another "AI is here so why bother" argument.
Also, there's a lot more to good documentation than just explaining what the code does.
Author here.
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.
Author here.
I infer you didn't like the article, but thanks for reading and engaging.