this post was submitted on 19 May 2025
185 points (97.0% liked)

Selfhosted

46671 readers
554 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
 

I've got to confess, I have for years been guilty if not reading the documentation. I simply go with the flow and hope it works...

But not anymore! And why the change you may ask? We'll, I'm reading the f..ing documentation on Rocky linux and I'm just blown away from the amount of great information!

If you've been guilty of not reading the documentation, let me me know what changed it for you

If you're not reading the documentation, this is your time to confess!

you are viewing a single comment's thread
view the rest of the comments
[–] corsicanguppy@lemmy.ca 15 points 3 days ago (1 children)

I worked next to a technical writer for Unix; the Unix. One of the things we were known for, actually, was the amazing documentation. This guy and both teams of writers (that many) maintained the doc as their entire job. It was written well, it was spell-checked, it was accurate, it was accessible. If you installed the machine, it was on http://localhost/doc or so.

Almost all tech writers were turfed after Y2K. They cost money and didn't earn directly.

If you notice a lack of good docco like you notice a lack of mentoring in code dev (I see you, Systemd), then we know how we got to this stage.

If you become CEO, just keep that in mind.

As a technical writer, I always get a bit giddy when someone shows appreciation for good docs haha Thanks for sharing!