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 must log in or register to comment.
Nothing teaches you what the documentation says like plowing ahead without reading it, fucking something up badly, having to crawl back to the documentation hat in hand and actually read it.
RTFM. …
… The last thing you try.Lol reading the source has trained me to try reading the documentation.
If it’s good, it’ll save hours or crawling through code.
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
Day 564: I have become lost in the forums amidst flake debate threads. Do not search for me, it is already too late.
You got a nice guttural laugh outta me for that one.
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.
I mean, it’s technical documentation. There’s a limit to how exciting it can be. lol.
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.
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.
You’re absolutely right
“F* you, I won’t read what you tell me!”
- Rage Against The Manual
so rally round your PC… with a pocket KVM
It’s weird that Linux certification requires rote-memorization of commands. The only people who make any effort to memorize commands are newbies and people studding for exams. You will always have access to bash history, man, and --help, even from an offline machine.
Every command I’ve memorized is simply the natural process of repetition. Is that your experience?
Yes. But also, despite having done it literally thousands of times, I still can’t tell you which way round to put the target and the link name for a softlink on the first go.
My first guess is always
ln -s $NAME $TARGETNo amount of repetition will fix this.
I feel seen
My trick to remember:
You can link to a target without giving a name to the link. ln will use the basename of the target file then. You can’t create a link without a target, so target has to go first since it’s not optional. Did it for me
I used to have that problem with ln until I realized it’s essentially the same ordering as cp: source, then destination. The source being the existing file that you’re linking to, and the destination being the link that you’re creating
🤣 same
deleted by creator
People are worried about losing skills to AI while all the skills have already been lost to Google and stack exchange 😅
Mine too. Been tinkering with Linux since I was a lad, sudo apt get / sudo apt update is ingrained into my brain.
Now, after running openSUSE Tumbleweed, sudo zypper ref / sudo zypper dup
Still a Linux noob, but I have never loved an operating system more than I have openSUSE. :)
While investing money to create good documentation is the preferred way, I cannot trust it to be accurate in this day and age of cutting corners. It takes a bit longer but I’ll always look at the code itself to get me closest to the truth of what is going on under the hood.
Man pages tend to assume a lot and overload the user with information.
Forums are full of “duh, haven’t you read the man pages, idiot?” kinds of people.
Web searches are full of AI/garbage (same thing) articles that focus on distros/programs that are either horrendously inaccurate, out of date, or simply don’t exist anymore.
Therefore, I utilize the
tldrman pages, and use extremely specific terms for web searches.Man can be searched as well, if you use less or grep a lot the same keys work.
Use / to search
Yes, I am painfully aware. Unfortunately, this doesn’t actually help.
Oh thank hell it’s not just me. Every so often I retry the man command only to get frustrated having to flip through six walls of text via keyboard for something a 20 second Internet search would have easily refreshed my memory on.
FYI
Use / to search the man page, it’s basically less. Been doing that for years, as some man pages are the length of the great wall of China.
Bingo.
And even then it’s difficult to find shit, like for instance, finding the working directory for
crontabwhen run as root. This answer on Stack Exchange is the embodiment of my second example in the other comment. The answers go into great detail, yet still don’t answer the question in any reasonable capacity for a “standard user” like myself.Oh it is certainly not just you, I am sometimes confused reading them even for commands I have used for years and I know what flag I am looking for but don’t remember the exact syntax or something hah! I am glad they are there but they are definitely not a complete guide to any command, especially built-ins.
Interestingly, this is something AI has been very useful for to me, less searching because I can describe the outcome I want and it figures out what I am talking about generally.
I have found the docs the best place to start with anything, but have found that some don’t know how to write good documentation.
Also man pages and the tools own help -? Or -h
If you run something that has pants docs, you could always see if there is a way to help update it
i stopped reading most docs after like 95 unless they are rfc or reference and i had a memory that was stellar
now, i read all of them over and over and over because i got a tbi from electroshock “therapy” and i am working with shitty autobiographical memories and cant get to the details. so i read, keep reading, and make sure all the mans are at hand along with my references. now i get frustrated and wanna die but i still get it done but im always like yeah uh no
Oh it happens to the best of us. I was working on a simple cron the other day with the cron string that would insert the cron into my cron config something like ‘echo’ and the normal string you’d recognize, and ended with a ‘-’. I wasn’t paying attention and issued the command which did insert itself into the cron config, but in a manner in which I didn’t want. It replaced the whole cron file with that one string. #$@^$$ Luckily I have a cron to back up the crontabs.
well I’d read the documentation if websearch wasn’t so shoddy that I could find it in the first place /s
I mostly try to read the docs, but sadly good documentation is pretty rare.
What the … LOL
Gotta start somewhere 😅
