I was going to start a thread on one of the design forums but there isn't an overall
AS design forum, so I'm posting to the dev list instead.
We have been having a discussion within the TDM's about documenting the public vs.
"private" API's. The problem we continue to have is customers start using
API's that are usually, but not always, third-party libraries that are used as
implementation details for an API we do mean for them to use. Of course, then they start
asking for support of that usage.
As this discussion took place internally, we starting batting around the idea of
separately all the things we would like to be private into its own lib directory. So
having one lib directory where have all the API's that we intend to have
customers/users use, and one where we have everything else, so we can clearly communicate
what should be used and what shouldn't be used directly.
What do you guys think? Is this even possible?
Andy
--
Andrig (Andy) Miller
VP of Engineering
JBoss, a division of Red Hat, Inc.