>The wizard opens your browser to sign in, scans your machine for installed agents, and writes the config to each one. It supports over 30 agents. The user never sees a config file.
In this day and age, I find it interesting that no one is screaming about security and privacy concerns about this which is so prevalent on any social media platform including this one.
The framing shift that helps: instead of "how do I get users to read setup docs," ask "what would it take to have no setup docs at all." Usually ends up being a better product anyway.
Agreed; I don't think "Not X, but Y" is a reliable tell on its own, but taken as a whole TFA set off my AI writing spidey-sense big time. The intro takes three paragraphs of fluff (ironically) to say "My product used to have long docs, but after using a product with much shorter docs it made me reconsider my approach."
If a "developer" can't manage to read one paragraph in a readme, maybe the "developer tool" is not for them. As much as I usually hate gatekeeping, basic reading comprehension is a skill I'd happily gatekeep at.
In this day and age, I find it interesting that no one is screaming about security and privacy concerns about this which is so prevalent on any social media platform including this one.
I suspect there's two big parts to this:
1. Users expect batteries included and that everything "just works" the first time.
2. The language you used differs match your audience. E.g they search "gray" and find no results, however you've spelt it "grey"
Assuming this was written by a human, I think it is time to retire saying “this is not x it is y”.
The moment I see that I think the text is AI generated and I lose interest.
is annoying.
All you need is bash