Utilisation des branches avec GitHub
Fusion avec GitHub
Lorsque vous travaillez avec GitHub, vous pouvez fusionner vos branches dans la branche principale directement dans l'interface web. Pour ce faire, vous devez créer une pull request. Une pull request est une demande de fusion d'une branche à une autre. Le côté intéressant de cette approche est que vous pouvez demander à un collègue de passer en revue vos modifications avant de les fusionner. Cette page vous montrera comment créer et manipuler une pull request.
Pull request
Pour créer une pull request, vous devez tout d'abord vous assurer que votre branche est à jour avec la branche principale. Pour ce faire, vous pouvez utiliser les commandes Git vu aux pages précédentes. Si votre branche n'est pas à jour, la pull request ne pourra pas fusionner automatiquement votre code.
Une fois votre branche à jour, vous pouvez vous rendre sur la page de votre projet sur GitHub. Cliquez sur l'onglet Pull requests et cliquez ensuite sur le bouton vert New pull request. Vous serez redirigé vers une page où vous pourrez choisir les branches à comparer et fusionner. Typiquement, vous choisirez la branche main comme base et votre branche comme comparaison. Vous verrez ensuite les modifications que vous avez apportées à votre branche.
Si vous êtes satisfait des modifications, vous pouvez cliquer sur le bouton vert Create pull request. Vous pourrez alors ajouter un titre et une description à demande de fusion. Typiquement, vous voulez écrire un bref résumé de vos modifications et pourquoi vous les faites. Vous pouvez aussi ajouter un collègue pour qu'il passe en revue vos modifications. Une fois le tout rempli, vous pouvez cliquer sur le bouton vert Create pull request.
Si vous avez le droit de fusionner votre branche, vous verrez un bouton vert Merge pull request que vous pouvez cliquer pour fusionner votre code. Dans les gros projets, il est possible que vous n'ayez pas les droits de fusion. Vous devrez alors assigner un de vos collègues pour qu'il fusionne votre code.
Revue de code
Lorsque vous créez une pull request, vous pouvez demander à un collègue de passer en revue votre code. Cette approche très utile vous permet d'assurer que votre code répond aux standards de qualité de votre équipe. Votre collègue pourra alors commenter votre code et vous demander des modifications si nécessaire.
Pour accéder à l'outil de revue de code, vous pouvez cliquer sur l'onglet Files changed lorsque vous êtes sur la page de votre pull request. Vous verrez alors les modifications apportées à la branche à fusionner. Vous pouvez écrire vos commentaires de la façon suivante:
- En cliquant sur le bouton + à côté de la ligne de code que vous voulez commenter.
- En cliquant et glissant sur le bouton + pour écrire un commentaire sur plusieurs lignes de code.
- En cliquant sur la bulle Comment on this file pour écrire un commentaire général sur le fichier.
Si vous retournez dans l'onglet Conversation, vous pourrez aussi écrire des commentaires généraux sur la pull request. Vous pourrez aussi voir les commentaires de vos collègues et y répondre.