Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte I feel like this is so missing the opportunity.
If the agent isn't working well, improve the docs for humans first, and wire them in to the agent through tooling.
-
@skinnylatte I feel like this is so missing the opportunity.
If the agent isn't working well, improve the docs for humans first, and wire them in to the agent through tooling.
@aly @skinnylatte exactly how I feel whenever I read a CLAUDE.md/AGENTS.md
-
R ActivityRelay shared this topic
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte what if we use very explicit words in a particular order and use specialized punctuation to denote meaning
-
@aly @skinnylatte exactly how I feel whenever I read a CLAUDE.md/AGENTS.md
@aburka @aly @skinnylatte I read a random project's skills.md yesterday and was like "Why do the robots get better documentation than we do?"
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte @tante It's true
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte People are difficult, machines are easy*. All squishy and sweaty, with different education backgrounds and different levels of English, god forbid other languages. Who would ever want to cater to them?
Why yes, I work in documentation, why do you ask?
*Machines are also difficult. We just pretend they're not.
-
@skinnylatte I feel like this is so missing the opportunity.
If the agent isn't working well, improve the docs for humans first, and wire them in to the agent through tooling.
If the agent isn't working well, take the CEO that purchased it out back and shoot them.
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte Look, this is the only way that management will fund improving documentation at all.
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte Same thing with APIs. Stuff that previously couldn’t get an interface for whatever reason: Adding an MCP-Interface is suddenly possible.
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte
Wasup with GOG's TOS? Out of context somehow. -
@skinnylatte Look, this is the only way that management will fund improving documentation at all.
Unfortunately, I fully believe this. @cadey @skinnylatte
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
@skinnylatte Documentation is a fine art requiring patience, people skills and a deep understanding of what you are documenting. Rarely, it seems, is that understood by decision makers.
-
Some dudes would rather clean up documentation for AI agents than make documentation easier to read for everyone, such as people
Someone objected to ‘dudes’, apparently it’s sexist so I’ll just leave this here.
In California, everything and everyone is a dude
EDIT: i don't think there can be sexism towards men in tech. that's a bit like all of the reverse racism people.
-
Someone objected to ‘dudes’, apparently it’s sexist so I’ll just leave this here.
In California, everything and everyone is a dude
EDIT: i don't think there can be sexism towards men in tech. that's a bit like all of the reverse racism people.
@skinnylatte I just wish Californians who call everyone "dude" would realize that the rest of the world isn't California
-
Someone objected to ‘dudes’, apparently it’s sexist so I’ll just leave this here.
In California, everything and everyone is a dude
EDIT: i don't think there can be sexism towards men in tech. that's a bit like all of the reverse racism people.
Dude? Dude. Dude!
Add a Californian, I can attest that the above is a complete and meaningful conversation.
-
@skinnylatte I just wish Californians who call everyone "dude" would realize that the rest of the world isn't California
the rest of the world isn't California
I moved to California, but it's just a state of mind
It turns out everywhere you go, you take yourself, that's not a lie -
@spacehobo @skinnylatte except this really isn't true outside the US and it's just another case of American exceptionalism to use the excuse of "actually over here it's neutral" instead of apologizing
-
Someone objected to ‘dudes’, apparently it’s sexist so I’ll just leave this here.
In California, everything and everyone is a dude
EDIT: i don't think there can be sexism towards men in tech. that's a bit like all of the reverse racism people.
@skinnylatte we are all united in a great web of dude-hood, all made of the same dude-stuff, on this great spinning rock we call dude.
-
Someone objected to ‘dudes’, apparently it’s sexist so I’ll just leave this here.
In California, everything and everyone is a dude
EDIT: i don't think there can be sexism towards men in tech. that's a bit like all of the reverse racism people.
@skinnylatte I called everything & everyone "Dude" once
Nowadays I tend to call everyone "Honey"
