Travaillez à partir d'une branche de fonctionnalité, pas de votre branche main.¶
Avant de commencer à travailler sur votre changement, assurez-vous d'avoir créé
une branche. Par défaut, lorsque vous clonez la fourche de votre dépôt, vous
serez extrait sur la branche main. C'est une copie directe de la branche
main de BeeWare.
Bien que vous puissiez soumettre une demande d'extraction à partir de votre
branche main, il est préférable que vous ne fassiez pas cela. Si vous
soumettez une demande d'extraction qui est presque correcte, le membre de
l'équipe principale qui examine votre demande d'extraction peut être en mesure
de faire les changements nécessaires, plutôt que de donner un feedback demandant
un changement mineur. Cependant, si vous soumettez votre demande d'extraction
depuis votre branche main, les réviseurs ne peuvent pas faire de
modifications.
Travailler à partir de votre branche principale rend également les choses plus
difficiles pour vous une fois que vous avez terminé votre première demande
d'extraction. Si vous voulez travailler sur une seconde demande, vous aurez
besoin d'une copie "propre" de la branche principale du projet en amont sur
laquelle baser votre seconde contribution ; si vous avez fait votre première
contribution à partir de votre branche main, vous n'avez plus cette version
propre disponible.
Au lieu de cela, vous devez effectuer vos modifications sur une branche de
fonctionnalité. Une branche de fonctionnalité a un nom simple pour identifier
le changement que vous avez fait. Par exemple, si vous corrigez un bogue qui
cause des problèmes de compilation sur Windows 11, vous pourriez créer une
branche de fonctionnalité fix-win11-build. Si votre bogue est lié à un
problème spécifique qui a été rapporté, il est également courant de faire
référence au numéro de ce problème dans le nom de la branche (par exemple,
fix-1234).
Pour créer une branche fix-win11-build, exécutez :
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build