Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Don't agree. LLM generated docs are some of the worst because like I said, the LLM never trims, only amends. So we used to do X but now we've had an architectural change or some type of change where we should never do X. Instead of just removing the instructions to do X in the docs, it amends them, "we made the decision to no longer do X because of Y". Now it has X multiple times in context instead of just not having X in context at all.
 help



I hesitate to make blanket statements, since this is quickly evolving, but in general I agree. LLM generated docs will quickly degrade to overly verbose, unreadable crap.

Not just that they get stale, but if you're using the LLM to generate the doc you don't need it.

I don't think I've ever seen an agent review a doc and then NOT also go look at the code. So skip the middleman, just have the agent look at the code.


One funny observation is that while LLMs are great at coding, but they absolutely suck at generating content for themselves (or other LLMs).

They are truly horrible at generating docs, prompts, knowledge bases, memories, etc.


Created a skill to prune them appropriately and run it every evening.

That's a lot of rolling the dice to risk some interesting (and unseen) hallucinations.

Nope. Doesn't work. Not consistently. Not without overhead or maintenance.



Consider applying for YC's Winter 2027 batch! Applications are open till November 2.

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: