Documentation Considered (Increasingly) Harmful

3 pointsposted 19 hours ago
by albanie
(samuelalbanie.substack.com)

4 Comments

MountainMan1312

18 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

16 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

18 hours ago

    Of course, we are not there yet. The models still make mistakes.
Biggest mistake was publishing this fact-free hype-slop.

albanie

16 hours ago

Author here.

I infer you didn't like the article, but thanks for reading and engaging.