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

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.

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.

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…

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