[voidhorse]

> I always joke about documentation as write only content. It's the type of thing you are asked to write that then doesn't get used or read.

That's not actually true. It may be true now when everyone still has context, but if you built a sound system that will outlast your own contributions to it, the documentation becomes invaluable.

> People are skimming, not reading.

Yes. The cause of much suffering and misery in the modern world.

> And they'll mercilessly use LLMs to deal with long form drivel produced by their colleagues.

otoh, they also use them to generate more noise and drivel than we ever imagined possible. When it took human effort to pump out boring corp-speak, that at least put a cap on the amount of useless documentation and verbiage being emitted. Now the ceiling has been completely blown off. People who have been incapable of even crafting a single sentence their entire lives can now shovel volumes of AI-generated garbage down our throats.