• NaibofTabr@infosec.pub
    link
    fedilink
    English
    arrow-up
    10
    ·
    6 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@lemmy.world
      link
      fedilink
      arrow-up
      6
      ·
      6 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.

    • jjjalljs@ttrpg.network
      link
      fedilink
      arrow-up
      5
      ·
      6 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@feddit.de
        link
        fedilink
        arrow-up
        4
        ·
        6 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@infosec.pub
          link
          fedilink
          English
          arrow-up
          3
          ·
          6 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.

        • jjjalljs@ttrpg.network
          link
          fedilink
          arrow-up
          1
          ·
          6 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.