Versionsrichtlinie

SocketIO4j Versionsrichtlinie

socketio4j folgt Semantischer Versionierung unter Verwendung des Formats:

x.y.z  →  MAJOR.MINOR.PATCH

Bedeutung der Versionsnummer

MAJOR (x)

Erhöht, wenn:

• brechende API-Änderungen eingeführt werden

• Protokollverhalten geändert wird

• größere architektonische Neugestaltungen erfolgen

MINOR (y)

Erhöht, wenn:

• neue Funktionen oder APIs hinzugefügt werden

• Abwärtskompatibilität erhalten bleibt

PATCH (z)

Erhöht, wenn:

• Fehlerbehebungen angewendet werden

• Leistungsverbesserungen vorgenommen werden

• interne Refaktorierungen die öffentlichen APIs nicht beeinflussen

Strategie für Hauptversionen

3.x – Kompatibilitätslinie

• bewahrt die Kompatibilität mit dem übergeordneten Fork

• minimale Abweichung vom Upstream

• fokussiert auf Stabilität und Fehlerbehebungen

• keine größeren API-Neugestaltungen

3.y.z

4.x – LTS-Linie (bevorstehend)

• führt neue APIs und erweiterte Funktionalität ein

• enthält architektonische und leistungsbezogene Verbesserungen

• für Produktions- und Unternehmensnutzung ausgelegt

• Abwärtskompatibilität innerhalb der 4.x-Linie wird beibehalten

Aktueller Status: 4.0.0 ist derzeit in SNAPSHOT und in aktiver Entwicklung. Sobald als GA veröffentlicht, wird 4.x zur Long-Term-Support-(LTS)-Linie.

4.0.0-SNAPSHOT   ← Aktuell
4.y.z            ← Zukünftige LTS-Veröffentlichungen

5.x – Entwicklungslinie (geplant)

• zukunftsorientiert und experimentell

• kann brechende Änderungen einführen

• schnelle Iteration und Funktionsexploration

• nicht für Produktion empfohlen

5.0.0-SNAPSHOT

Veröffentlichungsqualifizierer

Vorabversionen werden mit nachgestellten Qualifizierern gekennzeichnet vor GA:

Qualifizierer	Beschreibung
-SNAPSHOT	aktive Entwicklung, instabil
-M1, -M2	Meilenstein-Veröffentlichungen
-RC1, -RC2	Release-Kandidaten
(kein Nachsatz)	General Availability (GA)

Beispiel für den Veröffentlichungsablauf

4.0.0-SNAPSHOT
4.0.0-M1
4.0.0-RC1
4.0.0        ← GA (LTS)

---

Stabilitäts- & Unterstützungszusagen

• GA-Veröffentlichungen sind produktionsbereit

• Patch-Veröffentlichungen (x.y.z) sind abwärtskompatibel

• Minor-Veröffentlichungen (x.y) fügen Funktionen hinzu, ohne APIs zu brechen

• Major-Veröffentlichungen (x) können brechende Änderungen einführen

• LTS (4.x) erhält:

  • kritische Fehlerbehebungen

  • Sicherheitsupdates

  • langfristige Wartung

• SNAPSHOT-Versionen sollten niemals in der Produktion verwendet werden

• Meilenstein (-M) und Release-Kandidat (-RC) Versionen sind zur Validierung und für Feedback gedacht

• Nur GA-Veröffentlichungen werden als vollständig stabil angesehen