09 — Branches et demandes de fusion

Une branche est une copie sûre du projet où vous pouvez travailler sans déranger main. Une demande de fusion (pull request) est la demande de ramener ce travail.

Quand une branche est nécessaire

• La modification est assez grosse pour qu'un travail à moitié fait casse des choses.
• Quelqu'un devrait la relire avant sa mise en ligne.
• Vous voulez tester une idée et pouvoir la jeter.

Pour une faute de frappe dans un document, commiter directement sur main convient très bien.

Créer une branche dans le navigateur

Au moment de commiter (chapitre 03), choisissez Créer une nouvelle branche pour ce commit et ouvrir une demande de fusion, nommez la branche, puis commitez. Les bons noms décrivent le travail :

docs/notes-vlan
fix/passerelle-erronee
feature/export-rapport

Ouvrir une demande de fusion

1. Allez dans Demandes de fusion → Nouvelle demande de fusion.
2. Choisissez la branche source (la vôtre) et la cible (main).
3. Titre = ce que fait la modification. Description = pourquoi, plus ce que les relecteurs doivent vérifier.
4. Cliquez sur Créer la demande de fusion.

Relecture

• Les relecteurs commentent ligne par ligne depuis l'onglet Fichiers modifiés.
• Poussez d'autres commits sur la même branche — la demande de fusion se met à jour toute seule.
• Une fois approuvée, cliquez sur Fusionner, puis supprimez la branche.

Conflits de fusion

Si main a modifié les mêmes lignes que vous, KabaForge vous demande de résoudre. Depuis votre ordinateur :

git switch ma-branche
git fetch origin
git merge origin/main
# ouvrez les fichiers marqués, gardez les bonnes lignes
git add .
git commit
git push

Protéger main

Paramètres → Branches → Ajouter une règle : exiger une demande de fusion et des approbations avant que quoi que ce soit n'arrive sur main. Recommandé dès que plus d'une personne travaille dans le dépôt.