Glossar
Was sind Conventional Commits?
Eine Konvention für Commit-Nachrichten, aus der sich Changelogs und Versionsnummern ableiten lassen. Aufbau, Typen und der praktische Nutzen.
Conventional Commits ist eine Konvention dafür, wie eine Commit-Nachricht aufgebaut ist, damit Maschinen sie lesen können: typ(bereich): beschreibung. Aus dem Typ lässt sich ableiten, was die Änderung bedeutet — und daraus wiederum ein Changelog und die nächste Versionsnummer.
Der Aufbau
feat(checkout): Apple Pay als Zahlungsart · fix(auth): Session lief nach Passwortwechsel weiter · docs(readme): Setup-Schritte ergänzt. Verbreitete Typen sind feat, fix, docs, refactor, test und chore. Ein ! oder ein BREAKING CHANGE:-Absatz markiert einen Bruch.
Wozu die Disziplin
Weil sich daraus Semantic Versioning ableiten lässt: ein fix erhöht die Patch-Stelle, ein feat die Minor-Stelle, ein Breaking Change die Major-Stelle. Das Changelog schreibt sich damit selbst — und zwar aus dem, was tatsächlich passiert ist, statt aus dem, woran sich jemand am Freitag erinnert.
Wann es sich nicht lohnt
Wenn niemand die Ableitung benutzt. Eine Konvention, aus der kein Changelog und keine Version entsteht, ist reine Formatpflege — dann reicht eine verständliche Nachricht in ganzen Sätzen.
In Zuuna
Zuuna erzwingt kein Format. Es liest aus der Commit-Nachricht die Karten-ID und verknüpft die Arbeit damit selbst; Conventional Commits und eine Karten-ID im selben Betreff vertragen sich problemlos.
Häufige Fragen
Muss ich Conventional Commits benutzen, damit Zuuna Commits verknüpft?
Nein. Zuuna sucht die Karten-ID in Nachricht oder Branch-Namen. Das Format der übrigen Nachricht ist ihm gleich.
Was ist ein Breaking Change?
Eine Änderung, nach der bestehende Nutzung nicht mehr funktioniert. Markiert wird sie mit einem Ausrufezeichen nach dem Typ oder einem BREAKING-CHANGE-Absatz — und sie erhöht die Major-Version.
Lohnt sich das für ein kleines Team?
Nur, wenn ihr die Ableitung nutzt. Ohne automatisch erzeugtes Changelog oder Versionsschema ist es zusätzliche Regel ohne Ertrag.