Okay, how much effort should an end user be expected to put into learning how to use software?
As much as they’re need to, as much as they’re willing to.
If you need to use the software, then also you need to learn how to (properly) use it. If it’s too much work because of the poor doc or because it’s just something hard to use for you (which could very well be, I don’t know but I do know I’ve failed myself to learn to use Emacs save that I don’t blame the devs or the docs that’s provided for free), then you need to either:
Spend some more time (to learn it better).
Spend some money to have someone make some digest version of a too technical doc that will help you. I decided not to do that with Emacs because I realized I could also not use the software and still be able to do my work fine.
Find another app that will suit your needs better and time/energy availability.
FLOSS is provided as is. The user is free to use it however they fancy (which is amazing) but as a user we’re entitled to no support either. And why would we?
I’m not Writing Their Fucking Manual for them. That is utterly insane.
No one is asking you to write the doc if you don’t feel like it, and that’s 100% fine: no one will ever blame you for not writing it either. I’m just telling you that if you think it’s too much work for you you should not expect anyone to do it for you either. End of the story.
But let me ask you this: would writing the manual really be that much more insane than, say, writing the hundreds of thousans of lines of code to make the application itself? And if you think it would be more work to write the doc than to create the app (and offer it for free) may I ask you why? It’s a real question, as I hope you realize I’m not trolling I’m just curious to understand your reasoning.
BTW, I’m no dev, I’m a mere (and non expert) user of FLOSS myself. So, I know quite well how frustrating docs can be ;)
As much as they’re need to, as much as they’re willing to.
If you need to use the software, then also you need to learn how to (properly) use it. If it’s too much work because of the poor doc or because it’s just something hard to use for you (which could very well be, I don’t know but I do know I’ve failed myself to learn to use Emacs save that I don’t blame the devs or the docs that’s provided for free), then you need to either:
FLOSS is provided as is. The user is free to use it however they fancy (which is amazing) but as a user we’re entitled to no support either. And why would we?
No one is asking you to write the doc if you don’t feel like it, and that’s 100% fine: no one will ever blame you for not writing it either. I’m just telling you that if you think it’s too much work for you you should not expect anyone to do it for you either. End of the story.
But let me ask you this: would writing the manual really be that much more insane than, say, writing the hundreds of thousans of lines of code to make the application itself? And if you think it would be more work to write the doc than to create the app (and offer it for free) may I ask you why? It’s a real question, as I hope you realize I’m not trolling I’m just curious to understand your reasoning.
BTW, I’m no dev, I’m a mere (and non expert) user of FLOSS myself. So, I know quite well how frustrating docs can be ;)