Nobody Reads Your Setup Docs
hanzilla.co
Nobody Reads Your Setup Docs
1–10 of 23 posts
Re: Nobody Reads Your Setup Docs
#2Isn’t that the first one reads, when one wants to Setup? What changed?
Re: Nobody Reads Your Setup Docs
#3Isn’t that the first one reads, when one wants to Setup? What changed?
The first one i read is README
Re: Nobody Reads Your Setup Docs
#4“ And I realized my setup instructions weren’t documentation. They were a wall between my product and the people who wanted to use it.”
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.
Re: Nobody Reads Your Setup Docs
#5“ And I realized my setup instructions weren’t documentation. They were a wall between my product and the people who wanted to use it.” 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.
It feels ai-written, for sure. The sentence structure and idioms are very typical of ai writing these days.
Re: Nobody Reads Your Setup Docs
#6On a recent project we joked "developers can't read". Occasionally we'd ask for help and be pointed to the docs "I can't read".
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"
Re: Nobody Reads Your Setup Docs
#7So, how do your users uninstall it when they don't want it any more?
Re: Nobody Reads Your Setup Docs
#8lol too true, learned this the hard way
Re: Nobody Reads Your Setup Docs
#9[flagged]
Re: Nobody Reads Your Setup Docs
#10[flagged]
[deleted]