Trabalhe a partir de um ramo de recurso, não do seu ramo main.¶
Antes de começar a trabalhar em sua alteração, certifique-se de ter criado uma
ramificação. Por padrão, quando você clona a bifurcação do seu repositório, o
check-out é feito na ramificação main. Essa é uma cópia direta da ramificação
main de BeeWare.
Embora você possa enviar uma pull request do seu branch main, é preferível
que você não faça isso. Se você enviar uma pull request que esteja quase
correta, o membro da equipe principal que revisar a pull request poderá fazer as
alterações necessárias, em vez de fornecer feedback solicitando uma pequena
alteração. No entanto, se você enviar a pull request do branch main, os
revisores serão impedidos de fazer modificações.
Trabalhar no branch principal também dificulta para você depois de concluir o
primeiro pull request. Se quiser trabalhar em um segundo pull request, você
precisará ter uma cópia "limpa" do branch principal do projeto upstream no qual
basear sua segunda contribuição; se você fez sua primeira contribuição a partir
do branch principal, não terá mais essa versão limpa disponível.
Em vez disso, você deve fazer suas alterações em um feature branch. Uma
ramificação de recurso tem um nome simples para identificar a alteração que você
fez. Por exemplo, se você estiver corrigindo um bug que causa problemas de
compilação no Windows 11, poderá criar uma ramificação de recurso
fix-win11-build. Se o bug estiver relacionado a um problema específico que
tenha sido relatado, também é comum fazer referência ao número do problema no
nome do branch (por exemplo, fix-1234).
Para criar uma ramificação de recurso fix-win11-build, execute:
(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build