It is really really difficult to write good plain text instructions for other people to follow.
It’s a great experiment to try at home, or with a coworker - write up some directions for a task that the other person doesn’t already know how to do (something non-critical preferably) and ask them to try to complete the task per the directions without any other help. It is amazing how many assumptions we make about what seems obvious to us.
I get pushback at work about how I need to “be better at working with incomplete or vague instructions”, but “if it’s not in the spec the behavior is undefined, and you get what you get” is unacceptable.
Still mildly peeved about when product complained a list wasn’t sorted alphabetically. They’re lucky the order was deterministic at all
Are you not allowed to ask questions? Are the people who write the specs your team mates or are they your enemy? Of course you can play dumb, but that might result in your colleagues thinking that you are dumb.
It is really really difficult to write good plain text instructions for other people to follow.
It’s a great experiment to try at home, or with a coworker - write up some directions for a task that the other person doesn’t already know how to do (something non-critical preferably) and ask them to try to complete the task per the directions without any other help. It is amazing how many assumptions we make about what seems obvious to us.
I get pushback at work about how I need to “be better at working with incomplete or vague instructions”, but “if it’s not in the spec the behavior is undefined, and you get what you get” is unacceptable.
Still mildly peeved about when product complained a list wasn’t sorted alphabetically. They’re lucky the order was deterministic at all
Are you not allowed to ask questions? Are the people who write the specs your team mates or are they your enemy? Of course you can play dumb, but that might result in your colleagues thinking that you are dumb.