Introduction
Le flux GitHub est un workflow léger basé sur des branches. Le flux GitHub s’avère utiles pour tout le monde, pas seulement pour les développeurs. Par exemple, ici chez GitHub, nous utilisons le flux GitHub pour notre stratégie de site, notre documentation et notre feuille de route.
Prérequis
Pour suivre le flux GitHub, vous aurez besoin d’un compte GitHub et d’un dépôt. Pour plus d’informations, contactez l’administrateur de votre site. Pour plus d’informations sur la création d’un référentiel, consultez AUTOTITLE.
Suivi du flux GitHub
Conseil
Vous pouvez effectuer toutes les étapes du flux GitHub par le biais de l’interface web GitHub, de la ligne de commande et de GitHub CLI ou GitHub Desktop. Pour plus d’informations sur les outils que vous pouvez utiliser pour vous connecter à GitHub, consultez AUTOTITLE.
Créer une branche
Créez une branche dans votre dépôt. Un nom de branche court et descriptif permet à vos collaborateurs de voir le travail en cours d’un seul coup d’œil. Par exemple, ou . Pour plus d’informations, consultez « AUTOTITLE ».
En créant une branche, vous créez un espace dans lequel travailler sans affecter la branche par défaut. De plus, vous donnez à vos collaborateurs la possibilité de passer en revue votre travail.
Apporter des modifications
Dans votre branche, apportez les modifications souhaitées au dépôt. Pour obtenir davantage d’informations, veuillez consulter AUTOTITLE et AUTOTITLE.
Votre branche constitue un endroit sûr pour apporter des modifications. Si vous faites une erreur, vous pouvez revenir sur vos modifications ou pousser (push) d’autres modifications afin de la corriger. Vos modifications ne terminent pas dans la branche par défaut tant que vous ne fusionnez pas votre branche.
Commitez et poussez (push) vos modifications vers votre branche. Attribuez à chaque commit un message descriptif pour vous aider, ainsi que les futurs contributeurs, à comprendre les modifications que contient le commit. Par exemple, ou .
Dans l’idéal, chaque commit contient une modification isolée et complète. Cela permet de revenir facilement à la dernière version de vos modifications si vous décidez d’adopter une approche différente. Par exemple, si vous voulez renommer une variable et ajouter des tests, placez le renommage de la variable dans un commit et les tests dans un autre commit. Plus tard, si vous voulez conserver les tests, mais revenir sur le renommage de la variable, vous pouvez revenir sur le commit spécifique qui contenait le renommage de la variable. Si vous placez le renommage de la variable et les tests dans le même commit ou que vous propagez le renommage de la variable dans plusieurs commits, il vous faudra déployer plus d’efforts pour revenir sur vos modifications.
En faisant un commit et en poussant vos changements, vous sauvegardez votre travail sur un stockage distant. Cela signifie que vous pouvez accéder à votre travail à partir de n’importe quel appareil. Cela signifie également que vos collaborateurs peuvent voir votre travail, répondre à des questions et apporter leurs suggestions ou contributions.
Continuez à apporter, commettre et pousser des modifications dans votre branche jusqu’à ce que vous soyez prêt à solliciter des retours.
Conseil
Créez une branche distincte pour chaque ensemble de modifications non liées. Cela permet aux réviseurs d’émettre plus facilement leurs commentaires. Cela vous permet également, ainsi qu’à vos futurs collaborateurs, de mieux comprendre les modifications, de revenir dessus plus facilement ou de s’en inspirer. De plus, en cas de retard dans un ensemble de modifications, vos autres modifications, quant à elles, ne subissent pas de retard.
Créer une demande de pull
Créer une pull request pour demander aux collaborateurs de donner leur avis sur vos modifications. La révision des pull requests est si précieuse que certains dépôts exigent une révision favorable avant la fusion des pull requests. Si vous voulez obtenir des commentaires ou conseils précoces avant de finaliser vos modifications, vous pouvez marquer votre demande de tirage en tant que brouillon. Pour plus d’informations, consultez « AUTOTITLE ».
Quand vous créez une demande de tirage, incluez un résumé des modifications et du problème qu’elles résolvent. Vous pouvez inclure des images, des liens et des tableaux pour faciliter la transmission de ces informations. Si votre demande de tirage traite un problème, liez ce problème de sorte que ses parties prenantes aient connaissance de la demande de tirage et vice versa. Si vous liez avec un mot clé, le problème se ferme automatiquement lorsque la pull request fusionne. Pour plus d’informations, consultez « AUTOTITLE » et « AUTOTITLE ».
En plus de remplir le corps de la demande de tirage, vous pouvez ajouter des commentaires à des lignes spécifiques de la demande de tirage pour indiquer explicitement quelque chose aux réviseurs.
Votre dépôt peut être configuré pour demander automatiquement une révision à des équipes ou utilisateurs spécifiques lorsqu'une pull request est créée. Vous pouvez aussi manuellement noter ou demander une révision à des personnes ou équipes spécifiques.
Si votre dépôt comporte des vérifications configurées pour s’exécuter lors des demandes de tirage, celles qui échouent figurent dans votre demande de tirage. Cela vous aide à intercepter les erreurs avant de fusionner votre branche. Pour plus d’informations, consultez « AUTOTITLE ».
Aborder les commentaires de révision
Les réviseurs doivent laisser des questions, des commentaires et des suggestions. Les réviseurs peuvent commenter l'ensemble de la demande de retrait ou ajouter des commentaires à des lignes ou des fichiers spécifiques. Les réviseurs et vous-même pouvez insérer des images ou des suggestions de code pour clarifier les commentaires. Pour plus d’informations, consultez « AUTOTITLE ».
Vous pouvez continuer à commiter et pousser (push) des modifications en réponse aux révisions. Votre demande de tirage se met automatiquement à jour.
Fusionner votre demande de tirage
Une fois votre pull request approuvée, fusionnez-la. Votre branche est alors automatiquement fusionnée de sorte que vos modifications apparaissent dans la branche par défaut. GitHub conserve l’historique des commentaires et des commits dans le pull request pour aider les futurs contributeurs à comprendre vos modifications. Pour plus d’informations, consultez « AUTOTITLE ».
GitHub vous indique si votre demande de tirage comporte des conflits à résoudre avant la fusion. Pour plus d’informations, consultez « AUTOTITLE ».
Les paramètres de protection des branches peuvent bloquer une fusion si votre pull request ne respecte pas certaines exigences. Par exemple, vous avez besoin d’un certain nombre de revues d'approbation ou de la revue d’approbation d’une équipe spécifique. Pour plus d’informations, consultez « AUTOTITLE ».
Supprimer votre branche
Après avoir fusionné votre pull request, supprimez votre branche. Cela indique que le travail sur la branche est terminé et empêche vous et d'autres d'utiliser accidentellement d'anciennes branches. Pour plus d’informations, consultez « AUTOTITLE ».
Ne craignez pas de perdre des informations. L’historique de vos pull requests et de vos commits ne sera pas supprimé. Vous pouvez toujours restaurer votre branche supprimée ou annuler votre pull request, si nécessaire.