logoalt Hacker News

ruszkitoday at 8:18 AM1 replyview on HN

> An LLM can produce higher-quality documentation than most humans.

Can bears some heavy weight.

LLM generated documentation has so low level of information density, that it’s useless. Yes, it writes nice sentences… or even writes. But it contains so much noise that currently, reading code is a better documentation than what I’ve seen from every single LLM generated documentation.

The same with LLM generated articles. I close them after the second sentence because at least about 90% of it is useless filler.

Now compare that to this: https://slate.com/technology/2004/11/the-death-of-the-last-m...

I almost closed it when I read the first few sentences because these kinds of articles are useless time wasting nonsenses. But this was different. This was old. Most sentences contained something new. Something worthy. (Of course, people also write unnecessary long articles… looking at you Atlantic)

You can throw out almost everything by volume from LLM generated documentation without loosing any information.

Currently, if I smell (and it’s very easy to smell) LLM generated documentation or article, then I close it immediately, because it’s good for only one thing: wasting my time, for no good reason.


Replies

alwillistoday at 2:18 PM

> LLM generated documentation has so low level of information density, that it’s useless. Yes, it writes nice sentences… or even writes. But it contains so much noise that currently, reading code is a better documentation than what I’ve seen from every single LLM generated documentation.

I should clarify: the documentation I’m talking about is not generated using a generic LLM prompt, which would mostly suck.

With the proper context and additions (skills, plugins, MCPs) LLMs can produce high-quality documentation. You'd also have subagents doing QA of the documentation.

But it does require effort; it’s not magic.