This. Terminology, unknown concepts (some simply expected to be known, such as standard parameter syntax) and a lack of simple examples to understand all the abstract explanations with (like the way ‘tealdeer’ presents it) make manpages utterly useless to anyone but powerusers with lots of time and an interest in the topic.
Someone saying “RTFM” unironically in regards to Linux is basically a red flag for new users at this point. Not because reading manuals was bad, but because the manuals provided are simply awful. They’re developer- and expert-friendly, not user-friendly.
This. Terminology, unknown concepts (some simply expected to be known, such as standard parameter syntax) and a lack of simple examples to understand all the abstract explanations with (like the way ‘tealdeer’ presents it) make manpages utterly useless to anyone but powerusers with lots of time and an interest in the topic.
Someone saying “RTFM” unironically in regards to Linux is basically a red flag for new users at this point. Not because reading manuals was bad, but because the manuals provided are simply awful. They’re developer- and expert-friendly, not user-friendly.