On 10/07/2007, at 4:37 AM, Chuck Hill wrote:

This came out in the latest issue of ACM Queue. It is a very good article on API design issues and mistakes. It is a bit long but I think well worth reading:

http://acmqueue.com/rd.php?c.488

You can also get a free subscription to Queue. For a free computer magazine, this one is surprising worth reading. There is usually at least one article worth reading and the interviews are interesting.

Yes it was for the most part interesting. Many interesting points, but I thought he paid little attention to Design by Contract, which is the major way of good API design covering most of what Michi said, and documenting without documenting (yes that's what I meant to write, I think JavaDoc is horrible, like the bolts on Frankinstein's monster's neck) (and interestingly, the libraries that use DbC have very consistent naming conventions which greatly contribute to ergonomics). Still it is very much worth reading.

Glad you pointed out ACM Queue - I usually find CACM frustrating, although I did read an interesting article by Peter Naur in January's issue last weekend.

Actually Michi Henning is a blast from the past. He used to work at DSTC in Brisbane and I used to go there a lot doing distributed standards work. He was working on CORBA though which was not my direct interest (and I still think CORBA had a horrible IDL).

Ian


_______________________________________________
Do not post admin requests to the list. They will be ignored.
Webobjects-dev mailing list      ([email protected])
Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/webobjects-dev/archive%40mail-archive.com

This email sent to [EMAIL PROTECTED]

Reply via email to