Arbejd fra en feature-gren, ikke din main gren¶
Før du begynder at arbejde på din ændring, skal du sikre dig, at du har oprettet
en gren. Når du kloner din repository-fork, bliver du som standard tjekket ud på
din main gren. Dette er en direkte kopi af BeeWare grenen.
Selvom du kan indsende en pull-anmodning fra din main gren, er det at
foretrække, at du ikke gør dette. Hvis du indsender en pull-anmodning, der er
næsten korrekt, kan det centrale teammedlem, der gennemgår din pull-anmodning,
muligvis foretage de nødvendige ændringer i stedet for at give feedback med
anmodning om en mindre ændring. Hvis du imidlertid indsender din pull-anmodning
fra din main gren, kan gennemgangere ikke foretage ændringer.
At arbejde ud fra din hovedgren gør det også vanskeligt for dig, når du har
afsluttet din første pull-anmodning. Hvis du vil arbejde på en anden
pull-anmodning, skal du have en "ren" kopi af upstream-projektets hovedgren, som
du kan basere dit andet bidrag på. Hvis du har lavet dit første bidrag fra din
main gren, har du ikke længere den rene version til rådighed.
I stedet bør du foretage dine ændringer på en feature branch. En feature
branch har et simpelt navn, der identificerer den ændring, du har foretaget.
Hvis du f.eks. retter en fejl, der forårsager build-problemer på Windows 11, kan
du oprette en feature branch fix-win11-build. Hvis din fejl vedrører et
specifikt problem, der er blevet rapporteret, er det også almindeligt at henvise
til det pågældende problemnummer i branch-navnet (f.eks. fix-1234).
For at oprette en fix-win11-build feature-gren skal du køre:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build