I struggle to read long code docs even if they're 100% human-written and maintained, mainly because the longer the text, the greater opportunities for miscommun

I struggle to read long code docs even if they're 100% human-written and maintained, mainly because the longer the text, the greater opportunities for miscommunication, staleness, repetition etc. My point being, docs were already an unsolved problem in code. Of course LLMs dumping reams of docs is not good, but are we really sure it's worse than before? Undocumented code is bad, and mis-documented code is the worst.