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.
this post was submitted on 19 May 2025
79 points (97.6% liked)
Selfhosted
46672 readers
769 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:
-
Be civil: we're here to support and learn from one another. Insults won't be tolerated. Flame wars are frowned upon.
-
No spam posting.
-
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.
-
Don't duplicate the full text of your blog or github here. Just post the link for folks to click.
-
Submission headline should match the article title (don’t cherry-pick information from the title to fit your agenda).
-
No trolling.
Resources:
- selfh.st Newsletter and index of selfhosted software and apps
- awesome-selfhosted software
- awesome-sysadmin resources
- Self-Hosted Podcast from Jupiter Broadcasting
Any issues on the community? Report it using the report flag.
Questions? DM the mods!
founded 2 years ago
MODERATORS
I find that the docs usually consist of a quick start guide covering some ultra tight scenario that doesn’t apply to most people, and reference material that’s just some total brain dump of every possible command without any kind of context.
"F* you, I won't read what you tell me!"
- Rage Against The Manual
so rally round your PC... with a pocket KVM
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 tldr man pages, and use extremely specific terms for web searches.
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.
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.
Bingo.
And even then it's difficult to find shit, like for instance, finding the working directory for crontab when 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.
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 $TARGET
No amount of repetition will fix this.
Are you trying to say I'm not a newbie with over 20 years of experience?
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.
I thought you wrote confluence and wanted to grab my pitchfork.
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
Depends on what I am doing. Walky Talky? Toaster? Dish washer? ...... Who needs a manual for that?
FID detector? I need to know several things before turning it on. New Mainboard? Why is the WoL setting behind wake on PCIe?
Well, I've had a job where most coms were through a walky talky and somehow people didn't understand they had to think - push - talk 😅
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
well I'd read the documentation if websearch wasn't so shoddy that I could find it in the first place /s
I prefer to raw dog it first, break it, then tuck me dick and read the paper like the real alpha male
I'm kind of that way. I will browse documentation, get a good idea as to what has to happen, then I raw dog it. Then, after many failed attempts, I go read the documentation. I agree with twinnie@feddit.uk tho, a ton of documentation either assumes you are a certified, dyed in the wool, sysadmin veteran with a wall of certs, or it's just too sparse for me to put together.
I mostly try to read the docs, but sadly good documentation is pretty rare.
What the ... LOL
Gotta start somewhere 😅