Dieser Artikel beleuchtet die grundlegenden Prinzipien einer sinnvollen Branch-Namensgebung und stellt etablierte Best Practices vor, die sowohl in kleinen Teams als auch in komplexen Projekten den Entwicklungsalltag deutlich vereinfachen. Ziel ist es, Orientierung zu bieten und einheitliche Standards zu fördern, damit sich Entwicklerinnen und Entwickler auf das Wesentliche konzentrieren können: sauberen, wartbaren und kollaborativen Code.
Wichtige Prinzipien für gute Branch Namen:
- Prefix + Zweck sichtbar machen: Beginne Branch-Namen mit einem klaren Präfix, das angibt, wofür der Branch gedacht ist.
- Kleinbuchstaben und Bindestriche nutzen: Verwende ausschließlich lowercase und kebab-case (z. B. feature/login-page statt Feature/LoginPage). Das verhindert Probleme auf verschiedenen Betriebssystemen und ist in vielen Tools/CI-Pipelines stabiler.
- Kurz, aber aussagekräftig: Der Name soll auf einen Blick vermitteln, worum es geht — aber nicht so lang sein, dass er unübersichtlich wird.
- Optional: Issue- oder Ticket-Nummer einbinden: Falls ihr ein Issue-Tracking nutzt (z. B. Jira), kann das Hinzufügen der Ticket-ID im Branch-Namen helfen, Änderungen automatisch nachzuvollziehen. Beispiel: feature/123-feature-description.
- Einheitlichkeit im Team: Entscheide dich mit deinem Team für ein Schema — und haltet euch daran. Einheitliche Namen erleichtern Zusammenarbeit, Code Reviews und Automation.
Gängige Branch-Typen & Konventionen
| Prefix | Zweck / Beschreibung |
|---|---|
| feature/ | Neue Funktion / neues Feature |
| bugfix/ oder fix/ | Fehlerbehebung |
| hotfix/ | Kritischer Bugfix – meist direkt für Produktion |
| release/ | Vorbereitung eines Releases (Versionsbranch) |
| refactor/ | Code-Refactoring, ohne funktionale Änderungen |
| chore/ | Wartungsaufgaben, Dependencies aktualisieren, Infrastruktur |
| docs/ | Änderungen an Dokumentation |
| test/ | Neue Tests oder Test-Code |
| experiment/ oder spike/ | Prototypen, Experimente, Versuche ohne garantieren Merge |
Beispiele:
type/[ticket-nummer-optional]-kurze-beschreibung
- feature/user-authentication
- bugfix/42-fix-some-error
- hotfix/security-patch
- refactor/database-layer