NetBeans Forums
| View previous topic :: View next topic |
| Author |
Message |
Jaroslav Tulach
Posted via mailing list.
|
 Posted: Fri Dec 16, 2011 3:05 am Post subject: Devel & private was: Written contract between exporter and importer |
 |
|
| Quote: | ## 14. 12. 2011 20:57:43 ##<
| Quote: | Please invent different name and use it to avoid confusion with current
friend concept
|
Point taken. I am trying stable vs. semistable vs. unstable, which is a
little awkward verbally, but at least directly indicates the author's
expectation of how likely the interface is to be broken in an update,
which is what we mainly care about here.
|
We already have a stability category list
http://wiki.netbeans.org/API_Design#Life-cycle_of_an_API
and at least one does not have a clear meaning. It is the "under development"
one.
I see your proposal as a perfect way to give the logical category (e.g. "under
development") a physical meaning. Your currently preferred semistable seems
like a perfect way to enforce some accessibility rules associated with current
under development APIs. Thus I'd prefer to have
Stability.DEVEL
As the stability of currently internal, unpublished packages I suggest to use
Stability.PRIVATE
as that is clearly something people want to hide. All these terms are already
used in arch.xml and re-using them on the physical packaging level will
prevent dichotomy between the documentation and the APIs that realize it.
-jt |
|
| Back to top |
|
 |
|
|
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum
You can attach files in this forum
You can download files in this forum
|
|
FAQ
Search
Memberlist
Register
Profile
Log in to check your private messages
Log in
