News for hackers. Stuff that matters.
Re:Programmers will document for Claude, but not for each other by grumpymuppet on Friday June 05, 2026 @12:34PM (#48414881)
I bet a huge amount of that is on your head, or if it is factual, a function of a toxic work culture where people are primarily incentivized to "outperform one another" rather than arrive at collaborative solutions.

The wealthy/owner class once again consume all of us -- here through AI -- because we cannot agree to work together.

Re:Programmers will document for Claude, but not for each other by Kirth on Friday June 05, 2026 @03:31PM (#48417080)
This was also my first thought when reading the title: because Claude is a tool you use and co-workers are either competitors or people preferably dependent.. an anti-pattern and not good culture but sadly the norm.

That's not to say that the help-vampires the parent mentions don't exist. I think we culturally are afraid of pushing back against them: telling them to RTFM and then come back.

Re:Programmers will document for Claude, but not for each other by closeparen on Friday June 05, 2026 @12:53PM (#48415192)
Many companies, including in their software development functions, are oral cultures rather than literate cultures.
Re:Programmers will document for Claude, but not for each other by jason_oster on Friday June 05, 2026 @01:41PM (#48415821)
Re:Programmers will document for Claude, but not for each other by vitally3643 on Friday June 05, 2026 @12:42PM (#48415017)
No. It is a well established fact that the majority of users will not read documentation of any kind. This is not a new observation, it's been a meme in developer circles from the first day computers showed up in the workplace.

You can step off your high horse now.

Re:Programmers will document for Claude, but not for each other by satvikpendem on Friday June 05, 2026 @12:47PM (#48415104)
It's not just docs too, it seems to be some general phenomenon that users don't read most anything on screen.

This is from almost 20 years ago [0] and the original stretches back almost 30 years now [1].

[0] https://www.nngroup.com/articles/how-little-do-users-read/

[1] https://www.nngroup.com/articles/how-users-read-on-the-web/

Re:Programmers will document for Claude, but not for each other by socalgal2 on Friday June 05, 2026 @01:21PM (#48415563)
In my defense. (1) I can't find the docs (2) I can't find the relevant docs (3) after having read several irrelevant docs they still don't answer my question but the question I need answering isn't actually in the docs.
Re:Programmers will document for Claude, but not for each other by pixl97 on Friday June 05, 2026 @01:38PM (#48415768)
I would add on that if AI doesn't seem to understand your docs then humans are going to have an even harder time.

I've seen where when AI is asked a question on how to use some particular feature of a piece of software it couldn't get a working answer. I read the documents myself and was just as confused. Then looked up customer tickets around said feature, and they were confused too.

I've taken that as a pretty good metric that if AI can't parse your documentation, your documentation is bad or wrong and needs to be rewritten.