you are viewing a single comment's thread
view the rest of the comments
[–] 3 points 2 years ago* (3 children)

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.

  • source
  • parent
  • hideshow 6 child comments
  • 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.

  • source
  • parent
  • [–] 2 points 2 years 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.

  • source
  • parent