this post was submitted on 19 May 2025
200 points (100.0% liked)

Selfhosted

46677 readers
1059 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
[–] [email protected] 68 points 4 days ago (6 children)

If documentation is written in a readable and confluent way, RTFM isn't such a big deal. The issue comes with overly draconian and non-confluent documentation.

[–] [email protected] 7 points 3 days ago (2 children)

In my experience, all the Linux documentation I have read has been written for peers of Linux developers, who are familiar with technical terminology and several concepts and steps are left out and implied rather than explained.

It’s a way for developers to ensure that Linux never receives adoption past other developers. Literary equivalent of pulling the ladder up.

[–] [email protected] 4 points 3 days ago (1 children)

who are familiar with technical terminology and several concepts and steps are left out and implied rather than explained.

Said it before and I'll say it again: had to manually install some software to make Steam tinker launch work, and the instructions for installing it were to download and prepare the GitHub folder, then "do the usual and move the completed file to ..."

Ive used git in the past and it still took me multiple minutes to figure out they meant the "make && build" command. Why was that so hard to fucking write??

[–] [email protected] 4 points 3 days ago (1 children)

Highly specialized people live in bubbles and assume that everyone else lives in their same bubble and so if someone else doesn’t understand, they aren’t worth communicating with.

[–] [email protected] 3 points 3 days ago (1 children)
[–] [email protected] 2 points 3 days ago

Thank you for this. It’s beautiful.

[–] [email protected] 1 points 3 days ago

I mean, it's technical documentation. There's a limit to how exciting it can be. lol.

[–] [email protected] 7 points 3 days ago (2 children)

Looking at you, Nix documentation

[–] [email protected] 5 points 3 days ago

Day 564: I have become lost in the forums amidst flake debate threads. Do not search for me, it is already too late.

[–] [email protected] 1 points 3 days ago

You got a nice guttural laugh outta me for that one.

[–] RamblingPanda 9 points 4 days ago (1 children)

I thought you wrote confluence and wanted to grab my pitchfork.

[–] [email protected] 1 points 2 days ago (1 children)
[–] RamblingPanda 1 points 2 days ago
[–] [email protected] 6 points 3 days ago

There is a way with chmod in bash to change files and folders with files getting no execute bit and folder do (rwX instead of rwx). It's in the man pages but good luck finding it via Google. Stackoverflow just suggests using find over and over again.

That did it for me.

[–] [email protected] 8 points 4 days ago (1 children)
[–] [email protected] 20 points 4 days ago

Flowing/coming together.

I think what they are referring to are docs where pieces are explained individually, but not in a consistent or cohesive way, obfuscating use.

[–] [email protected] 4 points 4 days ago

You're absolutely right