2 ms·
> Great product designs require no manual, and similarly, great interfaces need no documentation. Imagine having to read a manual on how to use a coffee mug. I
by kmoser 3y ago
> Great product designs require no manual, and similarly, great interfaces need no documentation. Imagine having to read a manual on how to use a coffee mug.
It's a fallacy to assume a perfect interface needs no documentation, just as it's a fallacy to assume perfect code needs no comments. Most interfaces are far more complex than a coffee mug. In reality, the more complex something is, the more documentation is needed to describe how it works, how to use it, how not to use it, and why it works that way.
- sanderjd 3y agoYes and no to this, IMO. I think the best interfaces have a "happy path" simple usage that doesn't require documentation to intuit one's way through without any dangerous footguns but also doesn't do very much, and then an arbitrarily deep path into more powerful use cases requiring more detailed documentation.