Comment ouvrir une pull request sur GitHub
Les pull request font tourner le monde open source. Découvrez comment les utiliser pour contribuer à vos projets préférés.
Une pull request (PR) est une fonctionnalité de GitHub qui vous permet de proposer des modifications à un référentiel auquel vous n'avez pas d'accès en écriture. Les responsables du référentiel peuvent examiner ces modifications et, s'ils le souhaitent, les fusionner dans le référentiel d'origine.
L'ouverture de pull request sur GitHub est cruciale pour contribuer à des projets open source et collaborer avec d'autres développeurs. Apprenez à créer et ouvrir une pull request sur GitHub en quelques étapes simples.
Étape 1 : forker le référentiel
La création d'un référentiel sur la plateforme GitHub crée une copie, autrement appelée « fork » – de ce référentiel, sous votre compte. La création d'un référentiel vous permet d'apporter des modifications au code sans affecter le référentiel d'origine.
Pour créer un dépôt, accédez à sa page principale et cliquez sur le bouton fork dans le coin supérieur droit :
Remplissez le nom du référentiel (fork) et une description facultative, puis cliquez sur Créer un fork< :
Vous avez maintenant créé une copie du référentiel d'origine. Ce nouveau référentiel a une connexion avec l'original afin que toutes les modifications que vous apportez au code puissent être facilement comparées et fusionnées.
Étape 2 : apporter des modifications au code
Après avoir créé le référentiel, vous devrez peut-être le cloner sur votre ordinateur local, en fonction de la quantité et de la nature des modifications que vous souhaitez proposer. Si vous apportez des modifications très simples que vous n’avez pas besoin de tester, vous pouvez le faire en ligne à l’aide de l’éditeur Web GitHub.
Pour cloner un référentiel sur votre machine locale à l'aide de Git, exécutez cette commande de terminal :
git clone <REPOSITORY_URL>
Remplacez
Vous devez garder vos modifications petites et ciblées, car les demandes d'extraction volumineuses peuvent être difficiles à examiner et à fusionner. Essayez de garder vos modifications spécifiques à un problème ou à une fonctionnalité, pour permettre aux responsables de les examiner et de les accepter plus facilement.
Après avoir apporté les modifications souhaitées localement, validez-les et transférez-les vers votre fork GitHub à l'aide de Git.
Étape 3 : ouvrir une demande de tirage
Après avoir validé vos modifications sur GitHub, vous devriez voir une invite vous avertissant que votre branche a un certain nombre de « validations » en avance sur le référentiel à partir duquel vous l'avez dérivée, par exemple :
Cliquez sur Contribuer liste déroulante . En cliquant sur ce bouton, vous serez invité à ouvrir une pull request. Ensuite, cliquez sur Ouvrir la demande de tirage Bouton :
Certains référentiels ont des directives de contribution spécifiques, que vous pouvez généralement trouver dans un fichier CONTRIBUTING.md, que vous devez suivre. Assurez-vous de lire et de suivre ces directives avant de soumettre une pull request.
Ensuite, remplissez les champs obligatoires et cliquez sur le bouton Créer une pull request :
Votre message de commit doit être clair et concis, décrivant les modifications que vous avez apportées et le raisonnement qui les sous-tend. Cela aidera les responsables à comprendre vos modifications et leur permettra de réviser plus facilement le code.
Une fois que vous avez créé votre pull, vous devrez attendre que les responsables du projet l'examinent et le fusionnent ou le ferment. Les responsables peuvent avoir des suggestions ou des commentaires sur votre demande de tirage. Soyez ouvert aux changements et prêt à apporter des révisions s’ils vous le demandent.
L’importance des demandes de tirage
Les demandes d'extraction facilitent la collaboration entre les développeurs en leur permettant de proposer des modifications, de fournir des commentaires et de réviser le code. Cela contribue à favoriser un sentiment de communauté et de collaboration au sein d’un projet, conduisant à davantage de contributions et à un développement plus rapide.
De plus, les pull request organisent l'historique et le versionnage du projet en permettant aux responsables de garder une trace des différentes versions du code et des modifications apportées à chaque version.