Improving a design so it explains itself is better than writing documentation how to use a bad design
@be But better than both is writing documentation for a self-explanatory design that explains the design via a different paradigm, so between the documentation and the design, there's no way somebody's going to fail to understand it.
@be True. One of the best PMs I've known worked in an office with "Norman doors", i.e. you pushed them to open but they had big handles on the outside so a "PUSH" sign was needed to keep people from yanking on them and getting frustrated.
One day he came in with a screwdriver and removed the handles. No sign needed anymore.
Fosstodon is an English speaking Mastodon instance that is open to anyone who is interested in technology; particularly free & open source software.