4 ms·

Agents read the docs. People don't. That's the underlying reason.

• simoncion 4mo ago
  > People don't. People falling all over themselves to write docs for their pile-of-linear-algebra-with-a-smiley-face-painted-on-it [0] don't read the docs, no. People who give a shit about writing solid software that doesn't get them paged at three in the damn morning do. [0] The face is there to provide social-trustworthiness signals to engage the human pack-bonding instinct, natch.
  • Daishiman 4mo ago
    Your sarcasm is unwarranted, because what I said is true and reflects the experience of a lot of people. A decade ago I left a job and spent the last week thoroughly documenting every flow and code section of an app that I worked with, which was the core value proposition of the company. A couple years later I ask around and nobody even took a look at that. People just don't read, and there are actually good reasons for that, one of them being that documentation is outdated in most orgs and the effort to keep it up to date is greater than reading the code.
    • simoncion 4mo ago
      > ...what I said is true and reflects the experience of a lot of people. Wow. What I said is true and reflects the experience of a lot of people. Amazing!
      • Daishiman 4mo ago
        That's nice, but if you write docs and people don't read them then that's clearly not a winning strategy in many orgs.