799
you are viewing a single comment's thread
view the rest of the comments
[-] sunstoned@lemmus.org 3 points 2 years ago* (last edited 2 years 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 3 points 2 years 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 2 points 2 years ago

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

[-] IronKrill@lemmy.ca 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.

this post was submitted on 02 Aug 2024
799 points (96.6% liked)

Selfhosted

59955 readers
418 users here now

A place to share alternatives to popular online services that can be self-hosted without giving up privacy or locking you into a service you don't control.

Rules:

  1. Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.

  2. No spam.

  3. Posts here are to be centered around self-hosting. Please ensure it is clear in your post how it relates to self-hosting.

  4. Don't duplicate the full text of your blog or git here. Just post the link for folks to click.

  5. Submission headline should match the article title.

  6. No trolling.

Resources:

Any issues on the community? Report it using the report flag.

Questions? DM the mods!

founded 3 years ago
MODERATORS