flux de GitHub

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 Guide de démarrage rapide pour les dépôts.

Suivi du flux GitHub

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, increase-test-timeout ou add-code-of-conduct. Pour plus d’informations, consultez « Création et suppression de branches dans votre référentiel ».

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 plus d’informations, consultez Création de fichiers, Modification de fichiers, Changement de nom d’un fichier, Déplacement d'un fichier vers un nouvel emplacement ou Suppression de fichiers dans un dépôt.

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, fix typo ou increase rate limit.

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.

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 « Création d’une pull request ».

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 « Syntaxe d’écriture et de mise en forme de base » et « Relier une demande de tirage à un problème ».

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 également effectuer manuellement @mention 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 « À propos des vérifications d’état ».

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 « Révision des modifications dans les pull requests ».

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 « Fusion d'une pull request ».

GitHub vous indique si votre demande de tirage comporte des conflits à résoudre avant la fusion. Pour plus d’informations, consultez « Traitement des conflits de fusion ».

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 « À propos des branches protégées ».

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 « Suppression et restauration de branches dans un pull request ».

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.