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

Selfhosted

60409 readers
526 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:

Detailed Rules Post

  1. Be civil.

  2. No spam.

  3. Posts are to be related to self-hosting.

  4. Don't duplicate the full text of your blog or readme if you're providing a link.

  5. Submission headline should match the article title.

  6. No trolling.

  7. Promotion posts require active participation, with an account that is at least 30 days old. F/LOSS without a paywall has exceptions, with requirements. See the rules link for details.

Resources:

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

Questions? DM the mods!

founded 3 years ago
MODERATORS
 
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) (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.

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.