Pracuj z gałęzią funkcji, a nie z gałęzią main.¶
Zanim zaczniesz pracować nad zmianą, upewnij się, że utworzyłeś gałąź. Domyślnie
po sklonowaniu repozytorium fork zostaniesz przeniesiony do gałęzi main. Jest
to bezpośrednia kopia gałęzi BeeWare z main.
Chociaż możesz przesłać pull request z gałęzi main, lepiej tego nie robić.
Jeśli prześlesz pull request, który jest prawie poprawny, członek zespołu
głównego, który go sprawdzi, może wprowadzić niezbędne zmiany, zamiast prosić o
drobne poprawki. Jeśli jednak prześlesz pull request z gałęzi main, recenzenci
nie będą mogli wprowadzać zmian.
Praca nad główną gałęzią utrudnia również tobie po zakończeniu pierwszego pull
requestu. Jeśli chcesz pracować nad drugim pull requestem, będziesz potrzebować
„czystej” kopii głównej gałęzi projektu upstream, na której opierasz swój drugi
wkład; jeśli swój pierwszy wkład wykonałeś z gałęzi main, nie masz już
dostępnej tej czystej wersji.
Zamiast tego należy wprowadzać zmiany w gałęzi funkcji. Gałąź funkcji ma
prostą nazwę, która pozwala zidentyfikować wprowadzoną zmianę. Na przykład,
jeśli naprawiasz błąd powodujący problemy z kompilacją w systemie Windows 11,
możesz utworzyć gałąź funkcji fix-win11-build. Jeśli błąd dotyczy konkretnego
zgłoszonego problemu, często w nazwie gałęzi podaje się numer tego problemu (np.
fix-1234).
Aby utworzyć gałąź funkcji fix-win11-build, uruchom:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build