09 — Branches und Pull Requests

Ein Branch ist eine sichere Kopie des Projekts, in der Sie arbeiten können, ohne main zu stören. Ein Pull Request ist die Bitte, diese Arbeit zurückzuführen.

Wann Sie einen Branch brauchen

Die Änderung ist so groß, dass halbfertige Arbeit Dinge kaputt machen würde.
Jemand sollte darauf schauen, bevor sie live geht.
Sie wollen eine Idee ausprobieren und sie notfalls verwerfen können.

Für einen Tippfehler in einem Dokument genügt ein Commit direkt auf main.

Einen Branch im Browser anlegen

Wählen Sie beim Committen (Kapitel 03) Für diesen Commit einen neuen Branch anlegen und einen Pull Request starten, benennen Sie den Branch und committen Sie. Gute Namen beschreiben die Arbeit:

docs/vlan-notizen
fix/falsches-gateway
feature/report-export

Einen Pull Request eröffnen

Gehen Sie zu Pull Requests → Neuer Pull Request.
Wählen Sie den Quell-Branch (Ihren) und das Ziel (main).
Titel = was die Änderung tut. Beschreibung = warum, plus alles, was Prüfende beachten sollten.
Klicken Sie auf Pull Request erstellen.

Review

Prüfende kommentieren einzelne Zeilen im Reiter Geänderte Dateien.
Pushen Sie weitere Commits auf denselben Branch — der Pull Request aktualisiert sich selbst.
Ist er freigegeben, klicken Sie auf Pull Request zusammenführen und löschen anschließend den Branch.

Merge-Konflikte

Hat main dieselben Zeilen geändert wie Sie, bittet KabaForge Sie um Auflösung. Vom eigenen Rechner:

git switch mein-branch
git fetch origin
git merge origin/main
# markierte Dateien öffnen, die richtigen Zeilen behalten
git add .
git commit
git push

`main` schützen

Einstellungen → Branches → Regel hinzufügen: Pull Requests und Freigaben verlangen, bevor etwas nach main gelangt. Empfohlen, sobald mehr als eine Person im Repository arbeitet.