Explore o fluxo do GitHub
O GitHub é a melhor ferramenta para permitir a colaboração em seus projetos. O fluxo do GitHub é um fluxo de trabalho baseado em ramificações sugerido para o GitHub.
Nota
Para implementar o fluxo do GitHub, você precisará de uma conta do GitHub e um repositório. Consulte "Inscrevendo-se no GitHub" e "Criar um repositório".
Gorjeta
Você pode concluir todas as etapas do fluxo do GitHub através da interface da Web do GitHub, linha de comando, CLI do GitHub ou Área de Trabalho do GitHub.
A primeira etapa é criar uma ramificação em seu repositório para funcionar sem afetar a ramificação padrão, e você dá aos colaboradores a chance de revisar seu trabalho.
Para obter mais informações, consulte "Criando e excluindo ramificações em seu repositório".
Faça as alterações desejadas no repositório. Se você cometer um erro, poderá reverter ou enviar alterações extras para corrigi-lo.
Confirme e envie suas alterações para sua ramificação para fazer backup de seu trabalho para armazenamento remoto, dando a cada confirmação uma mensagem descritiva. Cada confirmação deve conter uma alteração completa e isolada, facilitando a reversão se você adotar uma abordagem diferente.
Qualquer pessoa que colabore com o seu projeto pode ver o seu trabalho, responder a perguntas e fazer sugestões ou contribuições. Continue a criar, confirmar e enviar alterações para sua ramificação até estar pronto para pedir feedback.
Gorjeta
Você pode criar uma ramificação separada para cada alteração para facilitar o feedback dos revisores ou para que você entenda as diferenças.
Quando estiver pronto, você pode criar uma solicitação pull para pedir feedback aos colaboradores sobre suas alterações. Consulte "Criando uma solicitação pull".
A revisão de solicitação pull é um dos recursos mais valiosos da colaboração. Você pode exigir a aprovação de seus colegas e equipe antes de mesclar alterações. Além disso, você pode marcá-lo como um rascunho, caso queira feedback ou conselhos antecipados antes de concluir as alterações.
Descreva a solicitação pull tanto quanto possível com as alterações sugeridas e qual problema você está resolvendo. Você pode adicionar imagens, links, problemas relacionados ou qualquer informação para documentar sua alteração e ajudar os revisores a entender o PR sem abrir cada arquivo. Consulte "Sintaxe básica de escrita e formatação" e "Vinculando uma solicitação pull a um problema".
Outra maneira de melhorar a qualidade e a documentação de RP e apontar explicitamente algo para os revisores é usar a área de sessão de comentários. Além disso, você pode @mention solicitar uma avaliação de pessoas ou equipes específicas.
Há outras configurações de solicitações pull, como solicitar automaticamente uma revisão de equipes ou usuários específicos quando uma solicitação pull é criada ou verifica para ser executada em solicitações pull. Para obter mais informações, consulte "Sobre verificações de status" e "Sobre ramificações protegidas".
Após os comentários dos revisores e a validação das verificações, as alterações devem estar prontas para serem mescladas e eles podem aprovar a solicitação pull. Consulte Mesclando uma solicitação pull."
Se você tiver quaisquer conflitos, o GitHub irá informá-lo para resolvê-los. "Resolver conflitos de fusão."
Depois que uma solicitação pull bem-sucedida é mesclada, não há necessidade de a ramificação remota permanecer lá. Você pode excluir sua ramificação para evitar que outras pessoas usem acidentalmente ramificações antigas. Para obter mais informações, consulte "Excluindo e restaurando ramificações em uma solicitação pull".
Nota
O GitHub mantém a confirmação e mescla o histórico se você precisar restaurar ou reverter sua solicitação pull.