RE: goals proposal: minimize public APIs and freeze API only afterm2"1.0 release"

[Jerome Lacoste <je...@coffeebreaks.org>]

On Wed, 2004-06-09 at 04:05, Vincent Massol wrote:
> Hi Jerome,
> 
> I have thought about the javadoc custom tag but in my opinion it doesn't
> work well. We've even tried it on Cactus. It's a good idea in theory but
> in practice the problem is that it's too fine-grained and thus too
> difficult to maintain.
> 
> -Vincent

I had that feeling. I reread your proposal, and I like it.

There are 2 types of reuse:
- the reuse to interact with the application
- the reuse to reuse some functionality

we can then perhaps combine your proposal with something saying if you want to interact, use the API/SPI components (most usualy interfaces).
If you want to interact with functionality, only reuse things that are in the util package, but do it at your own risk as ascendant compatibility is not 100% guaranteed.
These util classes and methods will go through a deprecated policy anyway before they change.

Jerome