À propos de l'historique des commits dans GitHub Desktop
Lorsque vous apportez des modifications à un référentiel, l'historique de vos validations doit permettre de comprendre comment vous êtes arrivé aux modifications que vous avez apportées. Pour aider les personnes à réviser votre travail et pour faciliter la recherche de la date et de la raison des modifications apportées à un référentiel, nous vous recommandons de suivre certaines meilleures pratiques, telles que :
- Organisation de vos validations dans un ordre séquentiel et facile à suivre
- Écriture de messages de validation clairs qui incluent votre intention et tout contexte nécessaire
- Création de petites validations qui contiennent des modifications connexes
Il est souvent difficile de suivre parfaitement ces meilleures pratiques au moment où l'on procède à des modifications. Vous pouvez vous rendre compte que vous devez annuler les modifications d'une validation que vous avez effectuée, modifier un message de validation ou réorganiser vos validations pour raconter une histoire plus claires. Avec GitHub Desktop, vous pouvez gérer l'historique des validations directement depuis l'interface utilisateur.
Note
Si possible, il est préférable d'éviter de modifier l'historique des validations qui ont déjà été envoyées au référentiel distant. D'autres contributeurs peuvent déjà avoir basé leur travail sur ces validations.
Options de gestion de l'historique des validations dans GitHub Desktop
| Option | Description | Informations complémentaires |
|---|---|---|
| Annuler une validation | Restaure les modifications d'une validation dans votre répertoire de travail, afin que vous puissiez effectuer d'autres modifications avant de valider à nouveau. Utile si vous avez fait une erreur dans les modifications que vous avez incluses. Impossible si vous avez déjà envoyé la validation au référentiel distant. | « Annulation d’un commit dans GitHub Desktop » |
| Réinitialiser le commit | Comme pour annuler un commit, cette option restaure les modifications de tous les commits jusqu’au commit sélectionné dans votre répertoire de travail. Ne peut être utilisé que jusqu’au dernier commit qui a été envoyé dans le dépôt distant. | « Réinitialisation d’un commit dans GitHub Desktop » |
| Modifier une validation | Permet de modifier votre récent message de validation ou de combiner de nouvelles modifications avec la validation la plus récente. Utile si les modifications de la validation précédente sont toujours valables, mais que vous avez apporté d'autres modifications qui s'intègrent dans la même validation. | « Correction d’un commit dans GitHub Desktop » |
| Rétablir un commit | Crée une nouvelle validation qui annule les modifications d'une autre validation dans votre historique. Utile si une validation a déjà été envoyée au référentiel distant, et que vous ne souhaitez pas supprimer la validation de l'historique du référentiel. | « Rétablissement d’un commit dans GitHub Desktop » |
| Cherry-pick une validation | Copie une validation d’une branche vers une autre. Utile si vous avez accidentellement validé des modifications sur la mauvaise branche, ou si vous devez appliquer une correction de bogue sur les différentes branches sur lesquelles vous travaillez. | « Exécution d’un cherry-pick d’un commit dans GitHub Desktop » |
| Réorganiser les validations | Modifie l’ordre des validations dans votre historique. Utile si la modification de l'ordre rend votre progression plus facile à suivre. | « Réorganisation des commits dans GitHub Desktop » |
| Squasher des commits | Combine plusieurs commits en un seul. Utile si vous avez une série de petites validations qui contiennent des modifications connexes. | « Squash de commits dans GitHub Desktop » |