• NaibofTabr
    link
    fedilink
    English
    107 months ago

    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.

    • @ThatWeirdGuy1001
      link
      67 months ago

      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.

    • @[email protected]
      link
      fedilink
      57 months ago

      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

      • elmicha
        link
        fedilink
        47 months ago

        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.

        • NaibofTabr
          link
          fedilink
          English
          37 months ago
          1. When the Master entered the Grand Temple he asked questions about everything there. Someone said, Do not tell me that this son of a villager from Tsou is expert in matters of ritual. When he went to the Grand Temple, he had to ask about everything. The Master hearing of this said, Just so such is the ritual.

          The Analects, Book III

          Always ask questions. Don’t be afraid of other people thinking that you’re dumb. Ask different people for the same answers. Listen to the way that they think about it.

        • @[email protected]
          link
          fedilink
          17 months ago

          People weren’t happy that planning meetings were taking longer because of all of the “what do you want it to do if such-and-such?” questions.

          Which kind of rolls into product not wanting to do their job, sometimes, but here we are.