logoalt Hacker News

bunderbundertoday at 12:26 PM2 repliesview on HN

Amen.

At work our documentation isn’t just getting littered with annoying jargon. It isn’t just all the hallucinations, either. (Since when has documentation ever been 100% trustworthy?) It’s that it’s so poorly written and structured that it’s becoming borderline incomprehensible.

My company is currently considering making, “Why should I bother to read something you didn’t bother to write?” an official policy because even the executives are starting to burn out on all the time they have to spend wading through slop.


Replies

mywittynametoday at 3:59 PM

I wish my company would do this. A coworker pulled an all nighter before a vacation and just left me with a million line claude summary of their work then just fucked off. The message was two-part due to size and lacked basic stuff like, "how to run".

He's going to be annoyed that none of that work was used. But the reality is, at least 75% of claude generated text is pointless.

show 1 reply
chrisandchristoday at 2:14 PM

If it wasn't worth your time writing, it isn't worth my time reading.

show 1 reply