789
submitted 4 months ago by Flax_vert@feddit.uk to c/selfhosted@lemmy.world
you are viewing a single comment's thread
view the rest of the comments
[-] sunstoned@lemmus.org 3 points 4 months ago* (last edited 4 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 3 points 4 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 2 points 4 months ago

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

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

this post was submitted on 02 Aug 2024
789 points (96.7% liked)

Selfhosted

40767 readers
1621 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 posting.

  3. Posts have to be centered around self-hosting. There are other communities for discussing hardware or home computing. If it's not obvious why your post topic revolves around selfhosting, please include details to make it clear.

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

  5. Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).

  6. No trolling.

Resources:

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

Questions? DM the mods!

founded 2 years ago
MODERATORS