Dear Wiki user, You have subscribed to a wiki page or wiki category on "Jclouds Wiki" for change notification.
The "DeprecationAndBetaPolicy" page has been changed by AndrewPhillips: https://wiki.apache.org/jclouds/DeprecationAndBetaPolicy?action=diff&rev1=4&rev2=5 Methods and classes that are regarded as experimental and which may change frequently can be designated as such by adding a {{{@Beta}}} annotation and a comment in the Javadoc, which explains when this method, class etc. was introduced. - Classes or methods marked as beta may change in a backwards-incompatible way even between minor versions, e.g. from MAJOR.MINOR to MAJOR.MINOR+1 + Classes or methods marked as beta may change in a backwards-incompatible way even between minor versions, e.g. from MAJOR.MINOR to MAJOR.MINOR+1. Beta methods and classes will be promoted to non-beta status only in major releases (e.g. MAJOR.0). + TODO: do we want to add an indication of how many MAJOR releases the user might have to wait? - jclouds aims to not promote a method or class out of beta - or to discard it - by the major release ''after'' next (i.e. A.D.0 if the current release branch is A.B.x). < I'm confused by this. I'm not sure what the intent is here. Could this be replaced by... - - Beta methods and classes will be promoted to non-beta status only in major releases (e.g. MAJOR.0) - - TODO: decide whether we're happy with a statement like that? The beta status is intended only for individual methods or classes. For entire providers and apis, see the next section. - === jclouds-labs === + ==== jclouds-labs ==== - jclouds-labs is the jclouds repository for experimental APIs and providers. Any functionality, including classes and methods, may change in a backwards-incompatible between minor versions. + Providers and APIs in the [[https://github.com/jclouds/jclouds-labs|jclouds-labs]] repository are also experimental. All functionality in jclouds-labs, including classes and methods is considered beta and may also change in a backwards-incompatible between minor versions. + This applies '''only to the jclouds-labs''' repository, not [[https://github.com/jclouds/jclouds-labs-aws|jclouds-labs-aws]], [[https://github.com/jclouds/jclouds-labs-google|jclouds-labs-google]] or [[https://github.com/jclouds/jclouds-labs-openstack|jclouds-labs-openstack]]. +
