You must log in or register to comment.
For appliances at least, 95% of “the manual” today is useless CYA safety disclosures in 17 different languages. Manuals today rarely contain useful information.
Until you do like step one of taking an appliance apart, and realize that the real manual is marked “for technician use only”, and it’s hidden inside of the appliance.
My washer and dryer both have good manuals complete with circuit diagrams under the top once i take a few screws out. My chest freezer has one taped up under the hatch where the compresser sits. My refrigerator has one hidden in the door hinge.
And software doesn’t even come with those kinds of manuals anymore.
I’ll read the manual after it stops working. There are 10 pages of “warning: don’t microwave your cat” and 10 pages of what obvious buttons do and if I’m lucky 3 pages of fault codes that in the worst case scenario I’ll see one of them the next 10 years.
Sometimes customers pay me to troubleshoot what other vendors sold them, I find the manual for their model number and basically flick through it until I find something.
Hey someone that reads the manual. As someone who makes manuals that makes me happy.
RTFM is an obnoxious retort for people, arguably in community, not to engage with a member of the community. I don’t mind reading the manual, but perhaps you can point me to where in the manual I could get further insight.
Reading a manual is also a skill. Being able to compartmentalize manual info into buckets of “obvious and I don’t need to read on”, “could be helpful”, “interesting, but it gets there I ain’t touching it” takes either training or just getting lucky after a certain number of reps.
Writing a manual is also a skill so starting with good ones help a lot.
RTFM is an obnoxious retort for people, arguably in community, not to engage with a member of the community.
I think there’s a low level of “How do I figure this out?” [generic] in which its good advice to ask “Does it say anything about this in the manual?” before you try and tear into a system as a third party giving advice.
I also think “I read the manual on my refrigerator” is some “I dare you to prove me wrong” horseshit. On the one hand, people don’t do this for a reason. Refrigerators simply aren’t that complicated to use. And the manual is rarely a smooth read, even for professionals. So its good advice, but not practical advice, better than half the time.
Reading a manual is also a skill. Being able to compartmentalize manual info into buckets of “obvious and I don’t need to read on”, “could be helpful”, “interesting, but it gets there I ain’t touching it” takes either training or just getting lucky after a certain number of reps.
Also, just a matter of free time and mental calories to burn. And hey, maybe if you’re a hobbyist who is hip deep in your Linux kernel because you eat this shit up, its the place you should have started. But also, Jesus Christ, maybe I just want a Mint instance to run a Jellyfin server. I’m not trying to get my master’s degree in this shit.
The only manual I need is the one that tells me how to shut his pompous ass up.
I don’t bother with manuals any more. I never manage to retain much information unless I need it right now. Way easier to just fumble along and find what I need when I need it and cobble together a half-baked “understanding”.
Should go get some ADHD meds one day.
Part of the fun of buying a game was getting to RTFM on the way home.
public transit, ftw… unless “I wish I died pecefully like my grandfather… the driver who was RTFMing, instead of his screaming passengers”
Last time I could buy a game with an instruction manual I was lucky that I could ride in a car without a car seat.
Yeah, this sure resonates with me. When I started with Linux to set up anything you had to RTFM. I remember constantly reading some “Linux printing How-To” or “Linux Wi-Fi How-To”. It definitely stayed with me. If I buy something and it has a manual I’m reading it. Just in case.
I work in maintenance, people act like I’m doing magic, but 90% of the time all I’ve done is read the fucking manual, the other 10% is just basic awareness.
It’s literally all this, all the way down until the turtles.
Holds manual
Squints
Turtles🦋 is this… Turtle Power?
Does reading medicine books count too? Since we’re all driving human bodies 24/7? Or is it just turtles down to the bottom of the tech layer.
Wasn’t it just one turtle down there?
Nah, it’s turtles all the way down.
Oh, so you’re þe guy I need to ask when I have any small problem and I’m too lazy to… RTFM.
I once read the first 3 chapters of the Git book and my coworkers think I’m some kind of Git wizard
One of the first things I did at my first full time job (while my very under prepared boss was looking for “junior-dev-friendly” tasks for me to work) was go to git-scm.com and just read through all the man pages I could. I spent a few days doing that, then my boss asked me to create a PowerPoint and present what I learned to the team. It was instantly apparent that I was the only one who knew anything beyond
git commit -aon the team at that point, and I was promptly appointed the “title” of “source control SME”. I’ve been heading up version control best practices for every team I’ve been on since (which is scary because the git cli has changed quite a bit since I read all those man pages but I haven’t had a chance to go back and refresh my knowledge).Do you have a blog or something? Do you write about your experiences regarding this?
These days I just ask llm to fork me a branch and whatever else I need :p
Literally same 💀
My folks bought a new EV recently and my dad was unable to figure anything out for days. I hopped in and was doing everything he wanted in minutes.
“How the hell did you do all that‽”
“I RTFM Dad”
“Reading! Kids, nowadays (sigh).”
I mean this is true and yes but in an age where documentation is increasingly terrible, the idea of a service manual for something you bought is basically a foreign concept, and half the shit you buy doesn’t come with a meaningful manual does it really apply the same way?
Like sure, knowing the post error codes on my motherboard or linux stuff is possible because it’s documented. But the appliance example? That is increasingly false and those manuals are increasingly becoming 5 page idiot guides: “here is how to turn the system on and off, here is how to turn heat up/down, contact authorized vendor for issues” and if you don’t do that then you void your warranty. Any more robust documentation is locked to “authorized vendors” and costs $$$, if it even exists (and doesn’t just say “replace system when it stops working correctly)
I partly disagree with what you say. The subscription appliance garbage absolutely do lock advanced user manuals behind paywalls. But it isn’t not rare (at least right now) to still find products with good user manuals. There are usually separate documents with one being a “quick setup” and another being a full “user manual”. Avoid the worst offenders and you should be okay.
Eh. I own a few old tools with manuals, and they actually have diagrams of the inner workings together with part numbers, some even have electrical diagrams with resistor values etc. All of the newer tools have a tiny useless “visit this website for more information” and 50% of the time it’s some bs about errors 1-10: restart device, 10-20 please contact a technician because opening the tool voids your warranty. I know dipshit, I don’t care about warranty cause I need the tool now or tomorrow, not in 3 months when you tell me it’s “unserviceable” or “uneconomical to repair” and I have to buy a new one.
Becoming increasingly rare and we are speaking on different things. You are talking about a manual that explains how to make your washing machine wash. That is important, yes, but I am talking about a manual that explains how an appliance works.
the days of a manual explaining anything like an error code are basically dead. Name one appliance manufacturer that lists anything beyond the most basic of troubleshooting (“turn it off and back on”)
Like go back and look at an appliance manual from the 70s/80s/maybe 90s and you will see a more robust explanation of what to do when things go wrong. The further back you go the more likely you will see parts numbers, circuit diagrams, or be able to order a service manual that has such information.
We expect this shit level of documentation because we live in a throwaway culture that has tolerated this pisspoor level of documentation for decades. “Oh the washer isn’t working? It’s showing an E-05 error? Guess we better just go buy a new washer” or pay the manufacturer $120 for a “service charge” to find out that code means the latch sensor died and it’s a $30 part that is a simple 5 minute job except you can’t get the part because they won’t sell it to you
My VIC-20 and Commodore 64 came with pinout charts. Every single internal and external connector was labelled.
LMBO, and sometimes it does come with a service manual, but you have to take the machine apart to find it like with my Samsung Washing machine
Most people don’t even read the error messages. They’re never gonna read a whole manual.
They don’t.
Undoing self-owns like ignoring available information is the basis for 40% of the economy.
People who don’t read error messages or do not take the time to see what is going on and just come to the technician/mechanic/doctor saying “it doesn’t work” or some half-assed hypothesis piss me off so bad.
I know that at some point we all do a little of this in our lifes, but some people don’t seem to be able to read one goddamn paragraph ever.
At this point, if a student brings in a laptop, explains what doesn’t work, and leaves me to diagnose and fix it, I consider it a good report because it means that the student didn’t get any overconfident ideas. If a student also explains what they were doing when a thing failed, I’m giving them preferential treatment.
Then there are comp-sci students who attempted something. I had one who disassembled their laptop and tore a ribbon cable. I had one who plugged in a random mis-matched RAM stick that turned out to be busted and wondered why Windows kept crashing. I had one who completely fucked up the registry. I had one who wanted to install Ubuntu for dual booting and accidentally wiped the entire SSD.
I would rather spend an hour babysitting their computers than an entire afternoon un-fucking something they thought they could handle. If it were up to me, I would restrict the crap out of their user accounts, but the faculty leaders insist, against empirical evidence, that they’re smart enough.
but some people don’t seem to be able to read one goddamn paragraph ever.
I had a problem with my car. It felt strange while driving. Made some unusual noise. Then a bit later the motor warning light came on.
I went to the garage, told them about the warning light and what I noticed the time before, what I suspected and such. A short while after the mechanic came to me and asked for a few details, as my description “wasn’t helpful” and the repair would be much faster with more details that told them where to look etc. Turns out the guy who checked in my car only noted “a warning light is on” and nothing else of my ramblings.
So sometimes it’s also paying attention to what might be important and relaying information.
ah well, then that is them being stubborn and being unable to troubleshoot.
To be fair, techs don’t usually talk to the people who can read, so they’re only ever going to see idiots. There are competent people in the world, they’ll just never need your help, so you don’t see them.
Last time I called tech support, it was for a Dell, and I interrupted their speech to tell them I already looked up the diagnostic. They asked which numbers were lit on the error panel to confirm I had the right diagnostic, and passed me directly to who I needed to talk to. I only called tech support because the cpu socket died and I was putting in a warranty claim, otherwise they would have never even heard from me because I could just install a new motherboard myself.
edit: speeling
They’ll refuse to attempt to understand the problem then get mad when they get ripped off.
Most people were conditioned by more “user-friendly” systems to ignore the content of error messages because only an expert can make sense of “Error: 0x8000000F Unknown Error”. So they don’t even try, and that’s how they put themselves in a
Yes, do as I say!situation.It’s not even obscure, context dependent errors. I’ve had many professional system administrators not understand what “connection was closed by peer” meant.
Well, to be fair, I’m also not very well versed in the intricacies of connecting with British nobility.
One day I’ll catch that jerk Peer! So rude, always closing my connections!
It’s very much on brand for Peer, at least in the beginning of the play https://en.m.wikipedia.org/wiki/Peer_Gynt
More than once I had trouble calls about an “error message” that basically said “everything is fine, click ok to proceed”
But most error messages are in plain English first (plus some numbers and codes).
No, they see white (gray actually) blocky text on a black background, they think the machine is broken and go into panic mode. Instead of reading.
Which is kinda what you said.
What about the fucking manual?
Kama Sutra?
I guess you get good at Unix and refrigerator by reading it, so why not?
Don’t fuck the manual!
It’s Read The Fucking Manual not Fuck The Reading Manual
I read the manual for every appliance I have. I do man and help even before using the command. I look for multiple articlse explaining the how and why before doing something new with my computer and yet when I look for help many tech people are condescendingly telling me to read the doc. Well, I did. But I don’t understand, because I coudn’t grasp the concept, because english isn’t my mother tongue, because many doc are written by great technician with poor writing skills that are bad pedagogues, and I would like someone to answer my question.
English is my mother tongue and I still have issues with reading some manuals because they’re written by bad pedagogues using jargon phrases that mean nothing, or worse, mean something completely different from a basic English reading of those words in that order.
Let’s not forget there is a lot of documentation written english by people who are not as fluent as they wish they be.
