RTFM

English

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.

  • 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

    • Meh… There have been a whole lot of braindead “pls do it for me” posts going around since the influx of windows refugees.

      I’m not one to be a prick about answering questions to help out, and we all start somewhere, but “help me get steam and my LLM working on Kali linux” where ppl get in way over their heads is becoming a real problem. Worse, they will call the linux community toxic for suggesting they need more fundamentals first.

      I interpret the post title as a general “try your best, and come to us when you’re stuck”.

  • 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

    • AI scrapers only know this outdated information

      While I have experienced this (quite a lot), it’s much easier to spend five minutes figuring this out with an AI than it is to spend an hour trying to work that out by searching forums for answers.

    • 3 hours

      I find AI way more up to date then searching.

  • 1 hour

    RTFM doesn’t have to literally mean to read text, just like saying “let me google that for you” doesn’t have to literally be google. Both statements are similar; the point is instead of burdening others with teaching you something, go learn it on your own whether that be the manual or random Indian tech youtuber.

    • 52 minutes

      Sometimes people ask others instead of googling things because it offers an opportunity to socialize. We all know google is an option. I get what you’re saying, but it’s sad to see this described as a burden.

  • I know It’ll be a controversial take on here; but while I don’t like the use of AI for most things, I’ve found LLMs to be immensely valuable when it comes to learning how to Linux, and as an extension, how to self host.

    I understand the limitations, but it’s so much more straightforward to tell an LLM what I’m trying to achieve then follow those instructions, than it is to try and poke about from site to site trying to piece together the information. Particularly if you don’t know what it is you need to search for in the first place.

    Obviously you have to exercise some caution, but it makes so much more sense to me to confirm instructions provided by an LLM than it is to try and figure out where to even start. And let’s be honest, not all forum users are as forgiving to complete noobs.

    • The problem with using an LLM for information is that you can ask chatgpt:

      "please provide me with 3 different interpretations of the main function of the Linux command ‘ls’

      and you’ll get what you ask for. An llm is an inappropriate tool to lookup accurate information.

  • 2 hours

    it’s just that it doesn’t work efficiently enough.

    Yeah, but we live in a world of limited resources. in particular labor and specifically knowledgeable linux nerds willing to answers questions for free. If everyone will have that mindset there won’t be a lot of time left to answer the difficult questions .

    With that said i agree that occasionally if its done its probably no big deal, there is also linux 4 noobs for those who want to ask some questions to help getting started with linux.

  • 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.

    • 3 hours

      Oh I hate how everything is a video. Sometimes I just want text so I can ship to relevant section.

  • “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!

    • often on linux, you can simply type man <command> and get TFM

      i would agree with you on GUI apps, where it can be confusing.

    • What’s worse, is if this is GNU-ware, there is a good chance the answer IS NOT IN THE MAN PAGE. I think it was bash or maybe gawk. I don’t remember exactly, but I had a question that simply wasn’t answered in each man page. GNU docs are absolute trash, written without any consideration for the audience.

      • 1 hour

        I think GNU favors the info tool, try that if the man page is lacking.

        • I feel like every time I’ve gone looking for an info page, it was just the man page content, but now I’ve got some useless shit I installed.

          I mean, maybe this is a debian thing.

  • do you mean man pages? man pages are awesome. man is like the biggest deal command in unix.

  • 5 hours

    Ι must say that Arch Linux’s wiki pages are easily understood. But man pages are not. I can’t follow the standard manual format. Just like with IKEA instructions, they just don’t make sense to me. My brain is like that. But Arch Linux pages are good.

    • 4 hours

      there’s a standardized man format? News to me. I thought developers just threw everything in at random order.

  • 4 hours

    I am not an expert but I will help you where I can!

  • RTFMP - I’d read the man pages if I could decipher them. 😁

    Mostly /s

    • I can’t count the number of times I swear I read every man page and I can’t figure out how to structure my arguments–especially when they are nested or conditional.

      I especially wish more man pages had common examples. Sometimes an example can say more than a paragraph of explanation.

      • I especially wish more man pages had common examples.

        A thousand times this. It’s all well and good telling us what each option does, but if we don’t know how to form the command around the various arguments and paths, then it’s all fairly useless.

      • 3 hours

        Caddy when I was trying to learn setting up encrypted hello.

    • I can relate : I’m a noon. I often don’t understand the manual, so I look for forum posts that are clearer/ easier to follow/more directly related to my problem and most of the time I find some.

  • It’s a skill like any other. When you need to look up something, make yourself at least try tldr, man, etc. first. Over time you will find yourself skimming through man pages to find what you need faster than looking up a video.

  • 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

  • If it’s a more complex subject matter i can understand people asking questions, because in those cases the documentation can also be more difficult to understand. I’ve asked questions in those situations myself as well, and a video of someone walking you through it can be very helpful. When someone asks the most basic questions ever i tend to be more on the RTFM side of things though. If you ask a question that literally has like a oneliner answer in the manual it seems to me like you didn’t put in that much effort before posting. I never actually RTFM’d someone though. I either answer anyway if i feel generous, or i just ignore it lol.