Hello Linux community.
I’d like to take a moment to explain what I hope will be a simple concept (so really it’s more of a reminder) that everyone should say least know and understand.
Not everyone (myself included) learns best by RTFM. Some of us need a guiding hand or to watch a video instead. It’s not that we’re lazy or don’t like reading, it’s just that it doesn’t work efficiently enough.
sadly dwarfed by YouTube videos that are outdated as soon as they are produced, and web guides nobody maintains. worse, AI scrapers only know this outdated information and happily hallucinate based on it it is EXHAUSTING having users cheer and celebrate the placebo of all the made up bullshit that does nothing in their config or worse breaks everything in unpredictable ways
I find AI way more up to date then searching.
Not to mention, RTfM is not always possible for some distros like NixOS where the documentation is weaker than for other more mainstream distros.
then you might be in over your head and shouldnt use what you are not able to use
That’s a round about way of saying RTFM, but even less welcoming. Probably not the kind of thing anyone should be told…
i see it more like telling somebody to weightlift 50kg first instead of immediately going for 500kg
What are you talking about?, NixOS documentation is one of the best ones around, not to mention that with just being pointed to the approximate direction of something and having a good text editor you can figure out things quite easily and without risk of breaking your system. I’ve recently switched from Arch and honestly as good as documentation is on Arch, I prefer NixOS one.
I am talking from experience here. Some of the documentation is out of date, some is meant for Channel NixOS installs and not so appropriate for Flake-based installs.
Most of the fixes for my issues I find across NixOS discourse forum posts, or in the subreddit of the other platform. The Wiki/official documentation is not enough.
I’m glad you switched to NixOS (welcome!) but this is gap in documentation is something that will become more apparent over time. The NixOS official wiki ironically often links to Arch wiki to explain certain concepts further.
RTFM long predates videos in the internet; at this point I’d actually call it inclusive of videos and guides.
I actually get pretty pissed off when the only guide for a feature beyond a couple lines of “here’s what this can do” with no elaboration is just a video. I don’t want a video. I want a damn manual with working examples.
But if its all there is, I’ll watch it before asking questions. The same should go for people who prefer videos, they should at least try the manual first, or looking at some guides or videos.
What’s frustrating for people (generically speaking) is when zero attempt is made in advance of posting questions, and from what I see, is the majority of “RTFM” responses.
I suggest to replace RTFM by WHYTSF : What Have You Tried So Far.
The goal isn’t to blame or guilt trip anyone, rather it’s to genuinely help and for that others need to know… WHYTSF?!
RTFM makes more sense in a professional context. I don’t expect anybody to read anything unless 1 they want to or 2 they are being paid to
Saying RTFM in a hobby or recreational space is just being an asshole for no good reason
RTFM is mostly a flex that people who got help before you are now referring to because they are already on the boat.
That said, a rudimentary Web search or maybe a llm question, might be in order before asking. You also learn more when you get those little successes by yourself.
What manual? What part of the manual? What if something happens that the manual didn’t cover? What if the manual is out of date or wrong? What if the maintainer of the manual made a mistake?
RTFM works for uncomplicated things and/or is a good starting place but is largely an unproductive thing to say these days in my opinion
Long time linux user: The worse problem is they don’t even tell WHICH manual is relevant to the issue.
“How do I make my secondary drive auto-decrypt?” “RTFM”
Could have at least said “man crypttab 5” so that I don’t have to waste 3 hours just trying to find the starting point.
“They”. That’s one sort of people who does RTFM the wrong way in my opinion. If I do RTFM, even for obvious simple ones, I most likely point to where to look at, ideally with a link. I do not RTFM literally, but saying there is some documentation and pointing to it usually. To me just saying RTFM (literally with this acronym) is rude, especially if someone already struggles and asks basic questions. Not everyone is “they”.





