Documentation Considered (Increasingly) Harmful

3 pointsposted 7 months ago
by albanie
(samuelalbanie.substack.com)

4 Comments

BillyTheMage

7 months 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

7 months 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

7 months ago

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

albanie

7 months ago

Author here.

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