Wie Versionsnummern funktionieren #

Diese Seite ist für Reporter, Redaktionen und Creator, die Versionsnummern richtig schreiben müssen. Exponential und die Pakete darum herum verwenden Nummern, deren letzte Stelle immer weiter hochzählt, was Menschen überrascht, die andere Schemata gewohnt sind. Die Reihenfolge falsch anzugeben, ist einer der leichtesten Fehler in der Berichterstattung über Releases.

Inhalt #

1. Die Teile einer Version
2. Die letzte Stelle zählt weiter
3. Tags, Branches und die Entwicklungslinie
4. Versionen richtig sortieren
5. Composer-Bedingungen in einer Tabelle

Die Teile einer Version #

Die Regel „Versionen haben im Fließtext kein v; das v gehört zum Git-Tag“ stammt aus den Regeln für Marke und Namen. Die Angaben zu 6.0.15stable und 6.0.x-dev stammen aus Den Code besorgen.

Die letzte Stelle zählt weiter #

Die Versionen von Exponential springen bei neun nicht um. Nach 6.0.9 kam 6.0.10 (28. August 2025), nicht 6.1.0 (Release-Übersicht). Dasselbe gilt für Erweiterungen und für Velocity:

• „Nach 0.1.9 ist das nächste Release 0.1.10; nur die letzte Stelle zählt hoch, sofern Sie nichts anderes entscheiden“ (Leitfaden für Erweiterungen, Veröffentlichen).
• „Die letzte Stelle einer Velocity-Version zählt über 9 hinaus weiter (0.0.4.9, 0.0.4.10, ...)“ (Den Code besorgen, das Velocity-Paket).
• „Versionen zählen in der letzten Stelle: Auf 0.0.4.9 folgt 0.0.4.10, nie 0.0.5.0“ (Release Notes von Velocity).

Lesen Sie einen Sprung in der letzten Stelle also nicht als kleines oder großes Release. Die Nummer gibt die Reihenfolge an, nicht den Umfang. Was ein Release enthält, steht in seinem Changelog (Ein Changelog lesen).

Tags, Branches und die Entwicklungslinie #

Nur ein Tag ist ein Release. Ein Branch bewegt sich jeden Tag; ein Tag nie (Veröffentlichte Versionen ändern sich nie).

Versionen richtig sortieren #

Eine einfache alphabetische Sortierung stellt v6.0.10 vor v6.0.8, sodass eine nach Namen sortierte Liste die falsche neueste Version zeigt. Die Dokumentation warnt: „Sortieren Sie immer nach Version (--sort=version:refname oder sort -V), nie nach Namen“ (Den Code besorgen).

git tag -l 'v6.0.*'                              # by name: v6.0.10 appears before v6.0.8 - misleading
git tag -l 'v6.0.*' --sort=version:refname       # by version: the newest tag is last - correct

Dasselbe gilt für Ihre eigenen Tabellen: Ordnen Sie Zeilen nach Release-Datum oder nach Version, nie alphabetisch.

Composer-Bedingungen in einer Tabelle #

Diesen begegnen Sie in composer.json und in Changelogs, die benötigte Pakete aufführen.

Wenn ein Changelog sagt, ein Paket „benötigt ~1.4.39“, schreiben Sie „benötigt Version 1.4.39 oder eine spätere 1.4.x“, nicht „verwendet Version 1.4.39“.

Verwandte Seiten #

• Kurzkarte der Namensregeln
• Veröffentlichte Versionen ändern sich nie
• Ein Release selbst überprüfen
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.