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!
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.
Looking at you, Nix documentation
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.
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??
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.
XKCD 2501, basically.
I thought you wrote confluence and wanted to grab my pitchfork.
rivers
Petrichor
Confluent?
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.