db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Db-derby Wiki] Update of "ForwardCompatibility" by DavidVanCouvering
Date Tue, 28 Mar 2006 21:43:09 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification.

The following page has been changed by DavidVanCouvering:
http://wiki.apache.org/db-derby/ForwardCompatibility

------------------------------------------------------------------------------
  === Stable ===
     * Incompatible change allowed in major release (X.0)
  
- This is an interface which we expect others to depend upon to remain stable enough for them
to build their own products or systems on top of.  Most of our public interfaces should be
given the stability level of Stable.
+ This is an interface which we expect others to depend upon to remain stable enough for them
to build their own products or systems on top of.  Most of our public interfaces should be
given the stability level of Stable.  Stable interfaces should never change between minor
releases, and even between major releases changes should be extremely rare.  
+ 
+ Any changes to Stable interfaces should be documented in the release notes.
  
  === Standard ===
     * Incompatible change allowed in major release (X.0)
  
  These are interfaces that we make available which are produced by a standards body, or which
is an industry standard that we feel is unlikely to change in incompatible ways.
+ 
+ Any changes to Standard interfaces should be documented in the release notes.
+ 
  
  === Unstable ===
     * Incompatible change allowed in minor release (x.Y)
@@ -80, +85 @@

     * Incompatible change allowed in minor release (x.Y)
  
  An interface can be downgraded from some other classification (such as Stable) to Deprecated
to encourage users to move to a newer interface that replaces this interface.  An interface
marked as deprecated must continue to be supported until the next major release.  An interface
can be reclassified as deprecated at any minor release boundary, but requires consensus approval
within the Derby community.  The interface must be clearly documented as deprecated in the
documentation and/or release notes, and if possible warnings should be issued when an interface
is used that it is deprecated (with the ability to turn these warnings off).
+ 
+ Interfaces that have been reclassified to Deprecated should be documented in the release
notes.
  
  == Interface Table ==
  

Mime
View raw message