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. Das jadice® web toolkit erweitert diesen Standard um eine weitere Stelle, die die Produktgeneration beschreibt und den von Semantic Versioning spezifizierten Stellen vorangestellt wird. Es ergeben sich also Versionsnummern der Form G.X.Y.Z (Generation.Major.Minor.Patch).

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

G.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.

G.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.

G. 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.

G .X.Y.Z

Diese erste Stelle wird von jadice® web toolkit hinzugefügt und beschreibt die Produktgeneration. Ein Sprung auf diesem Level wird dann vollzogen, wenn die Anzahl der Änderungen auf Major-Level eine einfache Migration nicht mehr zulässt. Der Generationswechsel beinhaltet Änderungen auf den anderen Levels und setzt diese auf 0 zurück.

[jadice web toolkit Version 5.10.21.0 : Dokumentation für Entwickler. Veröffentlicht: 2021-04-26]