Agents.md May Trick Us Into Writing Better Docs

As AI-powered coding assistants gain traction, a provocative question emerges: will the need for detailed documentation to feed these tools prompt developers to write better docs? Some commenters share concerns about the token usage costs associated with elaborate docstrings, while others argue that comments are meant for human developers, not machines, and should be kept separate from AI training data. One developer shares a practical approach, condensing comments into brief summaries with links to external documentation. The consensus seems to be that documentation is still essential, and the key is to be mindful of what's fed to AI tools.

Snapshot generated from the HN discussion