4 ms·
> Here's the problem I have. No doubt an LLM made it faster to write those docs, but did you fully spot check it for accuracy? Yes. That was just the writing p
by datakan 3mo ago
> Here's the problem I have. No doubt an LLM made it faster to write those docs, but did you fully spot check it for accuracy?
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.
- cogman10 3mo agoYeah, 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.
- jrochkind1 3mo agoIn 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.
- maleldil 3mo agoDid you skip the part where they describe the human pipeline the documentation goes through before publishing?
- fluoridation 3mo agoI 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?
- glaslong 3mo agoIn 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.....