End Of Life Procedures
From APIDesign
(New page: This section is good, and reminiscent of (symmetric to?) your section at the beginning of Part 3, "An API Must ...". One thing I would recommend: an additional section of this chapter abo...) |
|||
Line 4: | Line 4: | ||
--[[User:Dmkoelle|Dmkoelle]] 02:56, 23 April 2008 (UTC) | --[[User:Dmkoelle|Dmkoelle]] 02:56, 23 April 2008 (UTC) | ||
+ | |||
+ | "... but also whole packages like java.beans.beancontext that are there without any further reason." Why? This package has not been deprecated AFAIK and it may still be quite useful to some. | ||
+ | |||
+ | --[[User:TomWheeler|TomWheeler]] Wed Apr 23 20:38:48 CDT 2008 |
Revision as of 02:56, 24 April 2008
This section is good, and reminiscent of (symmetric to?) your section at the beginning of Part 3, "An API Must ...".
One thing I would recommend: an additional section of this chapter about communicating and distributing one's API. In my experience, a number of people have developed APIs which may be either good or bad, but which I have little chance of knowing, because it's presented so badly as to discourage me from investigating further, thereby rendering all of the work that went into the API somewhat useless. I know this isn't purely a software thing, but I think communicating an API clearly - what it does, what its limitations are, how it works!!! - is very important.
--Dmkoelle 02:56, 23 April 2008 (UTC)
"... but also whole packages like java.beans.beancontext that are there without any further reason." Why? This package has not been deprecated AFAIK and it may still be quite useful to some.
--TomWheeler Wed Apr 23 20:38:48 CDT 2008