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.
For me RTFM just means “show us you tried something yourself before reaching out for help”. In other words that you tried putting some work in and not just trying to get someone else to do your work or thinking for you.
I’m very happy to help someone willing to learn, but detest helping someone too lazy to do anything themselves.
That’s a fair point.
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”.
As a rule I don’t tell people to RTFM, because it has some rude dismissive connotations, although I will share when it helps me solve a problem I’ve been butting up against that would’ve been solved if I had just read the docs.
That being said, I do encourage people to read the docs, as others’ walkthroughs can be misinformational, and are usually tied to specific setups or software and hardware versions. It requires learning how to wade through a lot of information to find the info you need, but the info is usually guaranteed to be the most current and reliable.
That all being said, I’m more than happy to help when people want it.
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.
Oh I hate how everything is a video. Sometimes I just want text so I can ship to relevant section.
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.
While I agree that a little search is good for everyone, if no one asks questions publicly then no one has anything to find. I don’t trust llm accuracy so I don’t recommend that.
While not a reliable source on its own, it can usually point you in the right direction.
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?!
I’ve tried nothing and I’m all out of ideas.
That is great, it puts the onus on the asker to prove they tried something
additionally, and i’m sorry to say this, the fm often sucks. me being an enterprise architect by (one of my) trade(s), would usually benefit from an architecture or a systems sequence diagram… well this is rarely there :D and i’m saying this being a guy who originally learned to linux by methodically reading through, processing, and trial-and-erroring the complete set of man pages of my first distro, back in 97 or whatever.
“RTFM” (or similar comments like “it’s in the docs”) are just mean and useless without a reference.
Like, okay, superior user in the internet: If it’s in the manual/docs, what page? Do you have a link? Could you quote the relevant section?
Often people ask because they couldn’t find the answer in the docs. Simply pointing them at the answer is infinitely better than “lol the answer is in there somewhere”
See also: “Let me Google that for you…” Like mf Google brought me to this thread!
deleted by creator
The idea of RTFM is that if you have questions, then we are all on same page with basic information found in the manual. I mean you expect others explain what is already said in the manual. Its like asking how to use your microwave oven, even if you have the manual right at your hand. Now, if the manual is unclear or difficult to understand, that is a different story. Then you can at least say you didn’t understand it. The point is, that you did something before (your homework) and looked at the obvious places like the manual (and maybe further websearch).
People don’t like others being lazy and asking the questions that doesn’t need to be asked. That’s why RTFM exist. As much as you might take the “RTFM” as an offending answer, those people think of you question as offending too. Now there are people who use this term loosely in places when it is not appropriate. Also it depends on the audience. If your grandma tries to use a browser to watch funny cat videos, and asks how to use it, then it would be inappropriate to say RTFM. But if you have a Linux user who asks about how to use
grep, then I think it is an appropriate reply.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.
Tealdeer.
I am not an expert but I will help you where I can!
That’s all most of us noobs ever actually ask for, and it’s usually after we’ve gone through all the troubleshooting steps we know to do.
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
Exactly!
There’s a manual?
😆
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
Absolutely wrong. Only the manual (I mean official documentation, not a “howto” in someone’s blog) can provide you a complete and up-to date information.
The most wishful thing anyone has ever said in the history of ever
