> You could make software that doesn’t require your users to work around its shortcomings.

If the users are missing the mark so bad that they're wiping their asses with suede, I'd argue the documentation and examples are at fault.