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.
We have set recipes but somehow everyone makes each recipe different. It’s all the same ingredients in generally the same portions yet somehow I can tell who made what just based on taste or consistency.
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
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.
This is even funnier when working in a kitchen.
We have set recipes but somehow everyone makes each recipe different. It’s all the same ingredients in generally the same portions yet somehow I can tell who made what just based on taste or consistency.
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