Rusty's Bleeding Edge Page

| ----- | |

Free Software programmer
rusty@rustcorp.com.au

Subscribe
Subscribe to a syndicated feed of my weblog, brought to you by the wonders of RSS.

This blog existed before my current employment, and obviously reflects my own opinions and not theirs.

This work is licensed under a Creative Commons Attribution 2.1 Australia License.

Categories of this blog:
IP issues
Technical issues
Personal issues
Restaurants

Older issues:
All 2008 posts
All 2007 posts
All 2006 posts
All 2005 posts
All 2004 posts
Older posts

Rusty's Bleeding Edge Page

Tue, 01 Apr 2008

What If I Don't Actually Like My Users?

Here begins our descent into hell; if an interface manages to achieve negative scores on the Hard To Misuse List, your users may detect the dull red glow of malignancy rather than incompetence.

-1. Read the mailing list thread and you'll get it wrong.

If the first hit on Google when searching for the symptoms or how to use your interface leads to a convincing but incorrect answer, that puts your interface here.

**-2. Read the implementation and you'll get it wrong. **

This happens most often when the implementation being read is not the one you which ends up being used. Or maybe the implementation comes with test cases which all exercise the unnatural corners of the interface, which mislead instead of enlightening.

**-3. Read the documentation and you'll get it wrong. **

Here's my favorite (now fixed) example, from the glibc snprintf man page:

RETURN VALUE
       snprintf and vsnprintf do not write more than size bytes
       (including the trailing '

3.1 KiB Raw Permalink Blame History

Rusty's Bleeding Edge Page

Rusty's Bleeding Edge Page

Tue, 01 Apr 2008

What If I Don't Actually Like My Users?

3.1 KiB

Raw Permalink Blame History