Hacker News new | ask | show | jobs
by brookst 92 days ago
Classic perfect/good.

The choice is not usually “have humans write amazing top notch documentation, or use an LLM”.

The choice is usually “have sparse, incomplete, out-of-date documentation… or use an LLM”.

2 comments

And my claim is that the latter is better.
Cool, so just ignore documentation then. Problem solved for everyone.
I dont see how that solves anything.
* Projects can focus on code first, and do best-effort on docs for low cost * Most of us get reasonable quality documentation, much better than what some poor developer would turn out in spare moments * You are spared from the outrage of imperfect documentation
We wouldn't have these silly arguments?
Gah hopefully the meaning was clear from context, but I just realized I said "latter" when I meant "former". Inconsistent human documentation is better than miles upon miles of AI-slop documentation.
Given that people have access to LLMs themselves, publishing their output in lieu of good documentation (no matter how sparse) seems like it’s mostly downside.