Collaborer à plusieurs — Fork, clone, issues
Contribuer à l'open source et gérer les issues
Concepts Théoriques
Git et GitHub sont conçus pour la collaboration. Ce chapitre couvre les outils pour travailler à plusieurs et contribuer à des projets open source.
Fork — copier le projet de quelqu'un
Un fork est une copie d'un dépôt sur votre propre compte GitHub. Vous pouvez modifier votre fork librement sans affecter le projet original. Quand votre modification est prête, vous proposez une PR vers le projet original.
Workflow de contribution open source :
- Fork le projet (bouton "Fork" sur GitHub)
- Cloner VOTRE fork : git clone https://github.com/VOTRE-pseudo/projet.git
- Créer une branche : git checkout -b fix/typo-readme
- Modifier, commiter, pousser vers votre fork
- Créer une PR du fork vers le projet original
Issues — signaler et organiser
Les Issues sont des tickets pour signaler des bugs, proposer des fonctionnalités, ou discuter de questions. Chaque issue a un numéro (#1, #2, etc.) que vous pouvez référencer dans vos commits : "fix: correction du menu mobile (#7)" ferme automatiquement l'issue #7 quand la PR est mergée.
Les Labels catégorisent les issues (bug, enhancement, documentation, help wanted). Les Milestones groupent les issues par version ou sprint.
Git fetch vs git pull
- git fetch — télécharge les nouveaux commits depuis GitHub SANS les appliquer. Vous pouvez examiner avant de fusionner.
- git pull — fait git fetch + git merge en une commande. Plus rapide mais moins de contrôle.
> Bonne pratique : Avant de commencer à travailler, faites toujours git pull pour vous assurer d'avoir la dernière version du code.