Trabalhe a partir de um ramo de recurso, não do seu ramo principal ou main¶
Antes de começar a trabalhar na sua alteração, certifique-se de ter criado um ramo. Por predefinição, quando faz clone da bifurcação do seu repositório, faz checkout no ramo main. Isto é uma cópia direta do ramo main de BeeWare.
Apesar de poder enviar um pedido de puxar do seu ramo main, é preferível não o fazer. Se enviar um pedido de puxar que esteja quase correto, o membro da equipa principal que rever o seu pedido de puxar pode ser capaz de fazer as alterações necessárias, em vez de fornecer retorno a solicitar uma pequena alteração. No entanto, se enviar um pedido de puxar do seu ramo main, os revisores vão ser impedidos de fazer modificações.
Trabalhar no seu ramo principal também torna difícil para si depois de concluir o primeiro pedido de puxar. Se quiser trabalhar num segundo pedido de puxar, vai precisar ter uma cópia "limpa" do ramo principal do projeto do autor no qual basear a sua segunda contribuição; se fez a sua primeira contribuição a partir do ramo main, não vai ter mais essa versão limpa disponível.
Em vez disso, deve fazer as suas alterações num ramo de funcionalidade. Um ramo de funcionalidade tem um nome simples para identificar a alteração que fez. Por exemplo, se estiver a corrigir um bug que causa problemas de compilação no Windows 11, poderá criar um ramo de funcionalidade fix-win11-build. Se o seu bug estiver relacionado com um problema específico que foi reportado, também é comum fazer referência ao número do problema no nome do ramo (ex., fix-1234).
Para criar um ramo de funcionalidade 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