• sunstoned
    link
    fedilink
    English
    arrow-up
    3
    ·
    edit-2
    5 months ago

    Excellent notes. If I could add anything it would be on number 4 – just. add. imagery. For the love of your chosen deity, learn the shortcut for a screenshot on your OS. Use it like it’s astro glide and you’re trying to get a Cadillac into a dog house.

    The little red circles or arrows you add in your chosen editing software will do more to convey a point than writing a paragraph on how to get to the right menu.

    • funkless_eck@sh.itjust.works
      link
      fedilink
      English
      arrow-up
      3
      ·
      5 months ago

      I would also add that you need to explain out-of-home steps, too.

      I’m not an idiot but I didn’t go to school for compsci or similar and I don’t do it as a job. So frequently the instructions will go

      • Get your IP address by entering this command
      • Type your IP address in this line
      • Now forward any chosen port to your proxy of choice and don’t forget to check your firewall settings!

      My sibling in Eris, most people dont know any of those words.

    • SynopsisTantilize@lemm.ee
      link
      fedilink
      English
      arrow-up
      3
      arrow-down
      1
      ·
      5 months ago

      Absolutely! But I use markdown / Obsidian for my SOPs so images are kinda obnoxious to format. But yes!

    • IronKrill@lemmy.ca
      link
      fedilink
      English
      arrow-up
      2
      ·
      5 months ago

      I agree, but I don’t think images should be relied on as the primary communicator. I have seen far too many forums/websites/docs with broken images because the host went down. That and archivers are more likely to fail at saving images. Explain it using text and give a reference image to further display the point.