Also, there's a lot more to good documentation than just explaining what the code does.
albanie · 7h 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 · 9h ago
Of course, we are not there yet. The models still make mistakes.
Biggest mistake was publishing this fact-free hype-slop.
albanie · 7h ago
Author here.
I infer you didn't like the article, but thanks for reading and engaging.
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.
I infer you didn't like the article, but thanks for reading and engaging.