When I'm working on an API design from scratch I like to mock-up a program using the API even before I get to code. It can be as simple as a handwritten example

When I'm working on an API design from scratch I like to mock-up a program using the API even before I get to code. It can be as simple as a handwritten example. I find it a good way to get a "feel" for how the main parts of the API will work and it enables communication with other interested parties. (And I must be doing something right 'cos the API I designed for the libgmail Python binding was described by one columnist as a "work of art"[1]. :) ) [1] http://jonudell.net/udell/2006-02-07-gathering-and-exchanging-email-threads.html http://jonudell.net/udell/2006-02-07-gathering-and-exchangin...