IMO the best possible outcome of this AI hype is better documentation.

It's proven that (agentic) LLMs work better and more efficiently when they have the proper context for the project (AGENT(S).md), the documentation is accessible and up to date (docs/ directory with proper up to date markdown) and the tooling is smooth (git hooks that prevent secrets from being pushed, forced style checking and linting).

...surprise! All of this makes things easier for actual humans too!

▲

righthand a day ago | parent [-]

I think we’ll just get more documentation not better documentation. There never was a problem generating documentation from code. It’s the business context and use case documentation that’s hard to generate.

▲

alain94040 a day ago | parent [-]

There never was a problem generating documentation from code

That doesn't match my experience at all. Before AI, generating documentation from code was either getting some embedded comments for a function call, or just list a function's arguments.

AI reads the implementation, reads the callers and callees, and provides much smarter documentation, with context. Something sorely lacking from previous solutions. Is it sometimes not completely accurate? Probably. But still a giant step forward.

	▲	righthand a day ago \| parent [-]
		I think it depends on how good your documentation generator was before. Finding all the callers and callees is not a new idea to LLMs.