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.

Sign in to participate in the conversation

Fosstodon is an English speaking Mastodon instance that is open to anyone who is interested in technology; particularly free & open source software.