alt Hacker News> I’ve never shared Claude text output with another human without explicitly flagging it as such.
You've likely shared code written by OpenAI and don't mind subjecting other to it. So why should technical docs be different?
I think you're fighting a losing fight trying to get people to waste their time hand-writing tech docs just to avoid triggering over-sensitive Claude power users because they saw the word "gate".
Replies
Code and prose are different things, but that aside, no, I don’t expect anyone I work with to be subject to my mindless one-shotted PRs – which is as close a comparison I can think of on the development side. I also wouldn’t consider a readme to be a pure technical doc. It’s very likely to be the first, and possibly last, impression someone forms of your project. It matters.
I’m not fighting any particular fight, I’m just saying that the lack of care stands out to me, and evidently to others, and that anyone releasing a new project might want to consider whether they want it to be perceived in that way.
code is used to 'speak' to computers. prose is meant for human communication.
if your readme is meant to only ever be read by 'agents' then fine. if you want actual humans to read it, write in a human language, not LLM-speak.
it literally could not be more simple.