I agree 100% with the sentiment, but it 100% does not apply to Linux. The (when it actually exists which too often it doesn’t) ‘manual’ 90% of the time is written out of order by an expert presuming that 98% of what is being stated isn’t greek to the newb and consequently ends up being completely useless if not downright harmful for them.
My favourite so far is: App has feature that can be installed but requires several dependencies before it will install it. The feature has it’s own ‘handy’ cli command to point to an AppImage for a dependency which is useless because THE APP WON"T INSTALL THE FEATURE IN THE FIRST PLACE WITHOUT THE DEPENDENCY.
I don’t want to spend all my spare time for a week learning about commands and syntax for 5 other distros trying to figure out why this fucking [insert device that supposedly nobody else ever has a problem with] isn’t working. I’m not looking for a job in IT. I don’t want to burn my eyeballs out translating nerdspeak. This isn’t fun. I just want to click it and it works, which is apparently still too much to ask for after 20 years and 600 stupid distros later.
RTFM. GFY Linux. Learn how to write manuals first. Far as I can see, it’s a bunch of BS instructions that error out halfway through for some reason or another.
I agree 100% with the sentiment, but it 100% does not apply to Linux. The (when it actually exists which too often it doesn’t) ‘manual’ 90% of the time is written out of order by an expert presuming that 98% of what is being stated isn’t greek to the newb and consequently ends up being completely useless if not downright harmful for them.
My favourite so far is: App has feature that can be installed but requires several dependencies before it will install it. The feature has it’s own ‘handy’ cli command to point to an AppImage for a dependency which is useless because THE APP WON"T INSTALL THE FEATURE IN THE FIRST PLACE WITHOUT THE DEPENDENCY.
I don’t want to spend all my spare time for a week learning about commands and syntax for 5 other distros trying to figure out why this fucking [insert device that supposedly nobody else ever has a problem with] isn’t working. I’m not looking for a job in IT. I don’t want to burn my eyeballs out translating nerdspeak. This isn’t fun. I just want to click it and it works, which is apparently still too much to ask for after 20 years and 600 stupid distros later.
RTFM. GFY Linux. Learn how to write manuals first. Far as I can see, it’s a bunch of BS instructions that error out halfway through for some reason or another.
/rant off