In general people always seem to want documentation, so they can pull it up exactly when they need it, but will do anything to avoid actually having to read it until that singular moment.
The number of meetings where I can answer all the other attendees' questions because I'm the only one who even skimmed the presenter's docs, I swear.....
Yeah, IDK what to tell you then. Sometimes docs just go unread. There's a reason why "RTFM" is a meme.
It might be that they are wordy. It might be that your readers are lazy. It also might just be they don't realize the effort has been put in to make sure the docs are of high quality.
Re:Why I am not going to buy a computer
by jrochkind1 on Wednesday July 22, 2026 @12:03PM
(#49008930)
In this case, effort has _not_ been put in to make sure the docs are of high quality, and the potential readers know that, which is surely relevant.
Did you skip the part where they describe the human pipeline the documentation goes through before publishing?
Re:Why I am not going to buy a computer
by fluoridation on Wednesday July 22, 2026 @12:01PM
(#49008894)
I assume by "proof-reading" you don't mean just checking that the text doesn't contain spelling mistakes or is incoherent, but including that the content is actually correct. If your people actually invest that much into documentation, what the point of the LLM? Isn't the actual writing part like 10% of the total effort expended, in terms of man-hours?
Yes. That was just the writing portion, there is a whole team that works on publishing and proof reading and there are acceptance levels all the way up to the CISO where people validate they read it and approved of the contents. Even with that, no one cares about it.