Glossar
Was ist Semantic Versioning (SemVer)?
MAJOR.MINOR.PATCH — was die drei Zahlen bedeuten, wann welche steigt, und warum das für alles zählt, was jemand anderes benutzt.
Semantic Versioning gibt einer Versionsnummer eine Bedeutung: MAJOR.MINOR.PATCH. Aus der Nummer allein soll ablesbar sein, ob ein Update gefahrlos ist.
Die drei Stellen
PATCH (1.4.2 → 1.4.3): Fehlerbehebung, nichts ändert sich an der Benutzung. MINOR (1.4.3 → 1.5.0): neue Funktion, Bestehendes läuft weiter. MAJOR (1.5.0 → 2.0.0): etwas funktioniert nicht mehr wie vorher — ein Breaking Change.
Warum das jemanden interessiert
Weil es die Frage „kann ich das aktualisieren?“ ohne Changelog beantwortet. Wer eine API, eine Bibliothek oder ein Plugin veröffentlicht, verspricht mit der Nummer etwas — und ein Breaking Change in einer Minor-Version ist ein gebrochenes Versprechen, das bei allen Nutzenden gleichzeitig aufschlägt.
Woher die Nummer kommt
Sie lässt sich aus Conventional Commits ableiten: fix erhöht Patch, feat erhöht Minor, ein markierter Breaking Change erhöht Major. Damit entsteht die Version aus dem, was passiert ist, statt aus einer Entscheidung am Releasetag.
In Zuuna
Zuuna schreibt keine Versionsnummern vor: Eine Release hängt an dem Git-Tag, den du vergibst. Ob der SemVer folgt oder einem Datumsschema, entscheidest du — Zuuna bindet nur die Karten und Commits daran.
Häufige Fragen
Was bedeutet eine 0.x-Version?
Alles vor 1.0.0 gilt als instabil: Auch eine Minor-Erhöhung darf dort brechen. Deshalb ist der Sprung auf 1.0.0 vor allem eine Zusage über Stabilität.
Muss ich SemVer benutzen?
Nur, wenn andere von deiner Schnittstelle abhängen. Für ein internes Produkt ohne fremde Nutzung ist ein Datumsschema oft praktischer.
Was zählt als Breaking Change?
Alles, wonach bestehende Nutzung nicht mehr funktioniert — eine entfernte Funktion, ein umbenanntes Feld, ein geändertes Standardverhalten.