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.

  • Mactan@lemmy.ml
    link
    fedilink
    arrow-up
    0
    ·
    8 months ago

    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

  • Specter@piefed.social
    link
    fedilink
    English
    arrow-up
    0
    ·
    8 months ago

    Not to mention, RTfM is not always possible for some distros like NixOS where the documentation is weaker than for other more mainstream distros.

      • Specter@piefed.social
        link
        fedilink
        English
        arrow-up
        0
        ·
        8 months ago

        That’s a round about way of saying RTFM, but even less welcoming. Probably not the kind of thing anyone should be told…

        • Ajikeshi@lemmy.world
          link
          fedilink
          arrow-up
          0
          ·
          8 months ago

          i see it more like telling somebody to weightlift 50kg first instead of immediately going for 500kg

    • Nibodhika@lemmy.world
      link
      fedilink
      arrow-up
      0
      ·
      8 months ago

      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.

      • Specter@piefed.social
        link
        fedilink
        English
        arrow-up
        0
        ·
        edit-2
        8 months ago

        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.

  • curbstickle@anarchist.nexus
    link
    fedilink
    English
    arrow-up
    0
    ·
    8 months ago

    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.

  • utopiah@lemmy.ml
    link
    fedilink
    arrow-up
    0
    ·
    8 months ago

    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?!

  • Peasley@lemmy.world
    link
    fedilink
    arrow-up
    0
    ·
    8 months ago

    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

  • drastic133@lemmy.ml
    link
    fedilink
    arrow-up
    0
    ·
    8 months ago

    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.

  • Infamousblt [any]@hexbear.net
    link
    fedilink
    English
    arrow-up
    0
    ·
    8 months ago

    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

  • Shayeta@feddit.org
    link
    fedilink
    English
    arrow-up
    0
    ·
    8 months ago

    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.

    • thingsiplay@lemmy.ml
      link
      fedilink
      arrow-up
      0
      ·
      8 months ago

      “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”.