Skip to main content

Versionsnummernschema

jadice web toolkit nutzt als Basis für Versionsangaben das Konzept des Semantic Versioning. Semantic Versioning beschreibt die Syntax und Semantik einer Versionsnummer. Es wird eine dreistellige Versionsnummer der Form X.Y.Z definiert (Major.Minor.Patch).

Im Folgenden wird die Semantik der einzelnen Stellen kurz zusammengefasst (ausführliche und komplette Definition siehe http://semver.org/ ):

X.Y. Z

Die letzte Stelle der Versionsnummer gibt den Patch-Level wieder. Sie wird hochgezählt, wenn ein Release lediglich abwärtskompatible Bugfixes einführt. Ein Bugfix ist eine Änderung beziehungsweise Korrektur internen Verhaltens.

X. Y .Z

Die vorletzte Stelle ist der Minor-Level. Sie kann Änderungen auf Patch-Level beinhalten und wird hochgezählt, wenn Änderungen der folgenden Art vorgenommen werden:

  • Abwärtskompatible Erweiterung der öffentlichen API
  • Einführung abwärtskompatibler Funktionalität
  • Teile öffentlicher API wurden als "deprecated" markiert

Optional kann die Stelle hochgezählt werden, wenn signifikante interne Verbesserungen oder Funktionalität (ohne Änderung der öffentlichen API) eingeführt wurde.

Sobald der Minor-Level hochgezählt wurde, wird der Patch-Level (Z) auf 0 zurückgesetzt.

X .Y.Z

Diese Stelle ist der Major-Level und wird hochgezählt, wenn nicht abwärtskompatible Änderungen an der öffentlichen API vorgenommen wurden. Major Versionen können Änderungen auf Minor- (Y) und Patch-Level (Z) beinhalten. Sobald der Major-Level (X) inkrementiert wurde, werden Minor- (Y) und Patch-Level (Z) auf 0 zurückgesetzt.