40

We no longer say RTFM, read the fucking manual, anymore. I wonder why that is. Is it because more and more projects are moving all documentation to discord?

Some projects still have manuals... But there seems to be less expectation people will familiarize themselves with manuals anymore. I wonder why

all 29 comments
sorted by: hot top new old
[-] xantoxis@lemmy.world 51 points 2 years ago* (last edited 2 years ago)

"RTFM" was a terrible way to talk to people. It drove people away from projects. That was one of the first things any of us realized about the way open source maintainers and their projects' communities "supported" people: by blasting them until they retreated. It was something people said to new users for little while, thinking they were being funny, until it became The stereotypically rude thing you can say to a confused user, for the rest of time.

However, there has literally never been a time when technology was supported primarily by documentation. Not during the computer age, not before the computer age. People teach other people how to use things, it's how it's always worked and how we've always learned best. It's why schools exist.

I am by no means anti-documentation. I enjoy writing documentation; here's a screenshot of my homelab's documentation folder if you need proof.

But it's important to recognize that I write these things because I might need to look something up quickly as a reference, not because I expect anyone else to learn how to maintain (let alone build) my system by following the docs.

Reference manuals and tutorials are important to hook people into a project and support their use of it. Books are written to cover popular projects for people who, unlike myself, actually do prefer reading it all and have the patience for that. I just don't want us all to pretend that there's some moral failing if we haven't read the entire textbook before we ask a single question.

[-] jet@hackertalks.com 8 points 2 years ago

Very organized. And I do appreciate the architecture documentation you have. How are you enjoying immich?

[-] xantoxis@lemmy.world 4 points 2 years ago

Just got started with it! And actually it's working pretty wonderfully. I miss pet recognition, and I haven't learned how to make my phone sync there instead of google photos yet, but that's about the only issues right now. Fast, well designed, good tech.

[-] 1984@lemmy.today 3 points 2 years ago

I use immich too. The GPS coordinates from pics and the facial recognition grouping is very cool.

[-] BombOmOm@lemmy.world 47 points 2 years ago* (last edited 2 years ago)

A big part of it is manuals are increasingly non-present or unhelpful. Though, home appliances normally have useful ones still and I have used them on several occasional when doing repairs.

more and more projects are moving all documentation to discord

This is absolutely a trend that needs to stop. It is worse for individuals as info is completely unsearchable; and it is worse for the Discord admins and helpers as they have to answer the same questions over and over as nobody can find previous answers to the same question. A classic forum is optimal for public support.

[-] ptz@dubvee.org 39 points 2 years ago

I would love to RTFM if vendors would provide anything resembling them. Grrrrrr.

Like, I work with a lot of FOSS projects in my hobby-time. The absolute bulk of them have extensive documentation (online rather than printed, but it at least exists). At work, when my org pays a vendor big $$$$ for a solution, we're lucky to get a Word doc with a few unhelpful screenshots because they expect us to keep them on retainer for any support/technical issues.

Nerd rage over lol.

[-] bstix@feddit.dk 21 points 2 years ago* (last edited 2 years ago)

You'd be lucky to find TFM these days.

It's all IKEA sketches at best by now and if shit doesn't work you then can get a new one.

Best alternative is to Search The Fucking YouTube.

It's horrible, I know, but it's a pretty large database with some good users in between.

I recently had an issue with my car that the official brand mechanic couldn't fix or even be bothered to acknowledge. I searched all the forums (and read the manual), but I finally found the solution on YouTube. Thanks to 3rd party software I was able to download it for future reference, because who knows when it'll be taken down..

[-] sylver_dragon@lemmy.world 17 points 2 years ago

And good riddance. It was a dick-ish response to people who were already having a bad day. That said, you really can solve a lot of your problems by reading the manual (if one exists). And it certainly beats the hell out of the shit-show which is Discord "support". At least a manual is usually searchable and has some answers. And a good forum is usually also searchable and possibly indexed by major search engines (e.g. Google).

[-] Disaster@sh.itjust.works 7 points 2 years ago

This.

The trend to moving to discord is crappy for numerous reasons - the biggest one because i refuse to supply a phone number as the price of admission. Second, it's hard to find and search through old content on the platform. It's just a crap, proprietary rehash of IRC.

I'm sure it's great to be on the white-hot front of development for new projects, but to name a few... Podman, PipeWire, Etcd.... full documentation is patchy at best, a lot of common use cases aren't answered unless you find something on the Arch Wiki (for instance) - They're all great projects, but goddamn is it hard to find simple answers, and the more stuff moves off of github issues or forums and onto shit like discord, the less easy it is to even get a grip on the problem.

[-] TheImpressiveX@lemmy.ml 15 points 2 years ago

Forums: "Having an issue? Just read the manual!"

Manual:

If you have any issues, please contact a user on our forum.

[-] ted@sh.itjust.works 14 points 2 years ago

Rtfm is so unhelpful even when it is correct.

I guess it's a teach a person to fish mantra, but still.

[-] empireOfLove2@lemmy.dbzer0.com 12 points 2 years ago* (last edited 2 years ago)

The drive to forums makes most people just "Google it" for a step by step solution.

Also, most digital projects, and definitely most manufactured products, no longer provide any kind of user servicability. E.g, Factory service manuals are impossible to find for any automobile later than like 2006, they are all now obfuscated behind dealership database tools and subscriptions such that the information is never made publically available. And aftermarket manuals are flaky and incomplete at best, downright misleading and dangerous at worst. This basically applies to almost every consumer electronic, appliance, and frankly almost all digital software now too- real, detailed technical manuals just... aren't there. Because whoever is producing them makes more pure profit on selling service than the product.

Can't tell anyone to RTFM when there is no manual to read because the profit seeking corporation would rather you pay their dealer network $600 a visit to do basic simple things. When there is no manual, the only way left to learn about anything is either to start bodging it yourself until you figure it out (which most people are not capable of doing, or will destroy their property in the process), or rely on the forum posts of random people online who do have personal or professional experience with the things they're trying to fix.

[-] cerement@slrpnk.net 8 points 2 years ago
  • can’t RTFM when no one WTFM
  • software projects with manuals are an exception – most projects can’t be bothered (rare cases, they just export the API calls to a README and call that the manual)
  • hardware projects follow the stereotype of a manual in Chinese, machine translated to English, and distributed as a fourth generation photocopy
[-] jet@hackertalks.com 6 points 2 years ago* (last edited 2 years ago)

I haven't seen a good BOFH story in forever as well...

Maybe Reddit, and Google, got good enough that you could search for your specific problem without having to know the general documentation. And the expectation simply became point me to my specific problem

[-] drspod@lemmy.ml 4 points 2 years ago
[-] jet@hackertalks.com 3 points 2 years ago

Wow. I'm smiling ear to ear. This is great!

[-] baggins@beehaw.org 2 points 2 years ago

Welcome to The Reg.

[-] Varyk@sh.itjust.works 5 points 2 years ago

First I've heard of it.

Programmer thing?

[-] bionicjoey@lemmy.ca 5 points 2 years ago

RTFM= Read The (Fucking/Friendly) Manual

IMO it's harsh, but reasonable to say if the documentation for something is actually clear and concise. It's particularly relevant with software that has man pages since those are typically excellent.

[-] Kimdracula@sh.itjust.works 3 points 2 years ago

Yeah I have no clue what are they talking about

[-] Varyk@sh.itjust.works 3 points 2 years ago

Sounds like a programmer thing, telling noobs to read the manual

[-] 1984@lemmy.today 4 points 2 years ago* (last edited 2 years ago)

I guess we need Watch The Fucking Video these days don't we... :)

People don't read articles anymore, most people at least. They want some YouTube influencer explaining it quickly.

this post was submitted on 15 Jul 2024
40 points (85.7% liked)

[Migrated, see pinned post] Casual Conversation

3363 readers
1 users here now

We moved to !casualconversation@piefed.social please look for https://lemm.ee/post/66060114 in your instance search bar

Share a story, ask a question, or start a conversation about (almost) anything you desire. Maybe you'll make some friends in the process.


RULES

  1. Be respectful: no harassment, hate speech, bigotry, and/or trolling.
  2. Encourage conversation in your OP. This means including heavily implicative subject matter when you can and also engaging in your thread when possible.
  3. Avoid controversial topics (e.g. politics or societal debates).
  4. Stay calm: Don’t post angry or to vent or complain. We are a place where everyone can forget about their everyday or not so everyday worries for a moment. Venting, complaining, or posting from a place of anger or resentment doesn't fit the atmosphere we try to foster at all. Feel free to post those on !goodoffmychest@lemmy.world
  5. Keep it clean and SFW
  6. No solicitation such as ads, promotional content, spam, surveys etc.

Casual conversation communities:

Related discussion-focused communities

founded 3 years ago
MODERATORS