We have LLMs now. Why are the docs still wrong?

giancarlostoro

“WTFM!” “Write The Freaking Manual!”

arm32

I block domains on my home network younger than 30 days old. This one's blocked. Slop probable.

efilife

this is an ad

readme

Instead of reading the article I will tell you why the docs are wrong. It's because most teams don't incentivize writing documentation and a lot of them just don't care. The team guru's job security is predicated on knowing the answer to everything so it's a losing proposition for them. If you write good docs about one of these topics, don't be surprised if they try to find a way to punish you for it. If you're in an SWE job, only write documentation if someone tells you to. Otherwise, just give up.

euroderf

It might be slop, and it might be an ad, but the question it poses is entirely valid. But it does make me wonder if it undercuts the value prop for component-based content mgmt systems, because an LLM can cover an entire diverse documentation base effortlessly, without using components as a crutch for managing complexity.