And other people are better? Writing clear instructions that random people can follow is _hard_.
And other people are better? Writing clear instructions that random people can follow is _hard_.
Yes they are. There's a reason why product managers exist.
I don't think the author's point is that technical people can't write clear instructions, it's that technical individuals sometimes mock or deride others over things that "should be obvious".
> I don't think the author's point is that technical people can't write clear instructions, it's that technical individuals sometimes mock or deride others over things that "should be obvious".
That I can totally believe. But then again, non-technical people like to do that too - often the "obvious" thing being the one that they conveniently forgot to mention at all.
If companies weren't getting value from them, they wouldn't be hiring them.
> And technical people are basically the only ones who actually know how to write things in detailed and unambiguous enough way
No, that's exactly OP's point. Developers in general are terrible at writing explanatory text (if they even bother at all) because they make so many assumptions about background knowledge that others don't share.
Edit: Ok you said product managers. Which I suppose is reasonable, product managers should have a good understanding of developing products for customers.
I'm going to leave the top part of my comment because in retrospect its food for thought.
Are developers innately bad at understanding users? Is middle management better?
This disadvantage potentially extends to managers whose job includes understanding what the abstracted-over system is, but they're probably not thinking about it as hard on a day-to-day basis as the developers.
(Note that "non-developer users" probably also includes developers whose expertise does not extend to the specific system in question and therefore have no ability to guess what's leaking across the abstraction barrier, e.g., Linux users trying to use a Windows tool, new employees figuring out your in-house build system, etc. etc.)
I started developing just 3 years ago, after shifting from marketing and sales. Its amazing how most developers lack social skills needed to understand user trends. Yes, product managers are important to connect technical point of view with more abstract one. No, not all developers are like that, but I would say 2/3 at least.
Developers are mostly good at creating products that they would use. Once they enter ground where they create product for others - thats when difficult part begins.
Other people are remarkably less prone to arrogantly declaring everyone else to be idiots, in my experience. Tech is a field full of people who fondly imagine Dilbert as a documentary about a hero.
when I showed it in public in an event, I saw the same loop many, many times:
1> user press buttons confused, see I am standing nearby, ask me what they do. 2> I do nothing if they have a SO near. 3> SO points user, that there are descriptions of the button right there in front of them. 4> User slaps his forehead.
In case there was no SO near, then I would point it myself, the reaction of people was still the same...
I concluded that ins't just that people don't follow instructions, is that they don't even try.
Its not about how obvious you think it is, its about how hard it seems to the user. And the harder you make it the fewer users you'll have.
Secondarily, you put your instructions in printed form next to the screen -- when all the user cares about is the screen itself.
http://dirtsimple.org/2009/05/how-we-get-stuck.html
TL;DR: The author's SO got stuck trying to assemble a kitchen cabinet, and couldn't figure it out. The author looked at the problem, checked with the manual, discovered the solution immediately, and got called smart. The SO didn't even bother. And the author realizes that if their positions were swapped, he wouldn't bother either.
There's something wrong with the whole class of people - that mostly seems to coincide with the "non-tech" group, though maybe it's more about problem-solvers/not problem-solvers. What's wrong is that they get stuck on the first obstacle and give up. Instead of assuming that there must be a simple solution and searching for it, they assume it's broken and quit.
Also, related, the famous XKCD chart: https://xkcd.com/627/.
To be fair, compiler messages can be needlessly cryptic, but if you copy and paste the error into Google you'll almost always find someone who did the exact same thing and had it answered quickly.
Also: “In fact, users don't read anything.”
http://www.joelonsoftware.com/uibook/chapters/fog0000000062....