Geomajas Community Documentation
Versions have the structure "major.minor.revision". Geomajas uses a even-odd versioning scheme for the "minor" part.
The major number indicates major changes in the framework and thus gives no guarantee about API compatibility with previous major versions.
Versions with an even minor part are considered stable and suitable for production use. Odd minor versions are used for development to work on and test new features to be released in the next stable version. The API for Geomajas needs to be upward compatible for all stable versions with same major number. Specifically this means that
No API classes or interfaces may be removed.
No API classes or interfaces may be renamed.
No API classes or interfaces may have their package name modified.
No API methods may be removed.
No API methods may have their signature changed.
No methods may be added to classes annotated using
"@
".UserImplemented
Additionally, all methods and classes which are added should
include an indication of the version in which the class and/or method
was added. This is done using the "@since
" javadoc comment
for the methods, class or interface.
Because of the guarantees about API, the use of the
"@Deprecated
" annotation only indicates that a method or
class is not recommended to be used. The method or class will not be
removed in future versions with the same major number.