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.
linuxmemes
Hint: :q!
Sister communities:
Community rules (click to expand)
1. Follow the site-wide rules
- Instance-wide TOS: https://legal.lemmy.world/tos/
- Lemmy code of conduct: https://join-lemmy.org/docs/code_of_conduct.html
2. Be civil
- Understand the difference between a joke and an insult.
- Do not harrass or attack users for any reason. This includes using blanket terms, like "every user of thing".
- Don't get baited into back-and-forth insults. We are not animals.
- Leave remarks of "peasantry" to the PCMR community. If you dislike an OS/service/application, attack the thing you dislike, not the individuals who use it. Some people may not have a choice.
- Bigotry will not be tolerated.
3. Post Linux-related content
- Including Unix and BSD.
- Non-Linux content is acceptable as long as it makes a reference to Linux. For example, the poorly made mockery of
sudo
in Windows. - No porn, no politics, no trolling or ragebaiting.
4. No recent reposts
- Everybody uses Arch btw, can't quit Vim, <loves/tolerates/hates> systemd, and wants to interject for a moment. You can stop now.
5. ๐ฌ๐ง Language/ัะทัะบ/Sprache
- This is primarily an English-speaking community. ๐ฌ๐ง๐ฆ๐บ๐บ๐ธ
- Comments written in other languages are allowed.
- The substance of a post should be comprehensible for people who only speak English.
- Titles and post bodies written in other languages will be allowed, but only as long as the above rule is observed.
6. (NEW!) Regarding public figures
We all have our opinions, and certain public figures can be divisive. Keep in mind that this is a community for memes and light-hearted fun, not for airing grievances or leveling accusations. - Keep discussions polite and free of disparagement.
- We are never in possession of all of the facts. Defamatory comments will not be tolerated.
- Discussions that get too heated will be locked and offending comments removed. ย
Please report posts and comments that break these rules!
Important: never execute code or follow advice that you don't understand or can't verify, especially here. The word of the day is credibility. This is a meme community -- even the most helpful comments might just be shitposts that can damage your system. Be aware, be smart, don't remove France.
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.
God yes. I absolutely LOVE a well written manual.
Even if you THINK you know how a thing works, itโs always good to find out the quirks and gotchas, not to mention functionality that might not be obvious at first glance.
In fact, I read the manuals before buying an item or piece of software. They tend to be much more enlightening about a productโs limitations than the marketing material is.
Conversely, it really annoys the fuck out of me when people come on forums and ask a really basic question thatโs answered on page 2 of the manual. It shows that someone is incredibly lazy and incapable of basic problem solving. And they have the audacity to get offended when you tell them itโs covered in the manual.
Half of US adults can't read at a 6th grade level. This is haunting.
Some strikingly high percentage can't complete complicated tasks on a computer (eg: find 3 user email addresses and add them to a spreadsheet).
Reading the manual is good advice but I think some people are just left behind
I feel like a big problem is that a lot of people never learned how to learn.
Adding onto your examples, I've also heard about a study once where they were given similar basic Excel tasks. However, you didn't even have to solve the tasks. Instead, just trying to get help from the help function or searching online got you into the highest skill bracket. That bracket ended up being the smallest group.
It must be nice to be able to read and recall.
Never forget what they took from us.
copypasta levels
Sorry, I have a chronic medical condition that makes reading manuals physically painful, which prevents me from reading the manual until I encounter a problem that requires me to read it, at which point I will have likely discarded it. And if I haven't, I will only read through the part that contains the information I need to know to solve the problem and then immediately forget it after.
My biggest annoyance with man pages are that built-ins are a separate command and that there is no way to print all man pages but the first with the man command. That's right. There's no way to print every page for a command, 1 through 7 or whatever, with a flag. I am confidently saying there's no way to do it.
๐
Hoping someone wants to correct me because I want an alias that prints all pages as one. Would also be nice if it did it for built-ins.
Honestly, who has the time? I could read the manual or I could enjoy my life instead.
RTFDS is the equivalent for electric engineering enthusiasts. Itโs supposed to be tedious af, but I honestly enjoy reading data sheets for some god forsaken reason.
Started a new job as a tool tech in a rental center; maintaining, repairing, and simply showing people how to operate, a ton of different tools, some of which I've never even seen before.
First thing I did is setup a file share on my server that I've populated with 70+ manuals and growing by the day...
Read through them all myself to understand the nuances of each machine and be able to explain the details to customers; plus I can print them a fresh copy on demand just for good measure.