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 protected])
Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/webobjects-dev/mmwarner%
40mac.com
This email sent to [EMAIL PROTECTED]
_______________________________________________
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]
