Re: [OT] Good Article on API Design
Re: [OT] Good Article on API Design
- Subject: Re: [OT] Good Article on API Design
- From: Michael Warner <email@hidden>
- Date: Mon, 9 Jul 2007 14:21:49 -0700
I just read this article and found it to be very informative and
thought-providing.
Based on recent discussions about the need for documentation of
Wonder, etc. , I found the following
quote to be provocative:
"The worst person to write documentation is the implementer [me: the
author means the original creator of a method, framework or API],
and the worst time to write documentation is after implementation."
Mike Warner
On Jul 9, 2007, at 11: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.
Chuck
--
Practical WebObjects - for developers who want to increase their
overall knowledge of WebObjects or who are trying to solve specific
problems.
http://www.global-village.net/products/practical_webobjects
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Webobjects-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
40mac.com
This email sent to email@hidden
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Webobjects-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden