Explorar o fluxo de GitHub
O GitHub é a melhor ferramenta para habilitar a colaboração em seus projetos. O fluxo do GitHub é um fluxo de trabalho baseado em ramificação sugerido do GitHub.
Observação
Para implementar o fluxo do GitHub, você precisará de uma conta GitHub e um repositório. Confira "Criar conta do GitHub" e "Criar um repositório".
Dica
Você pode concluir todas as etapas do fluxo de GitHub pela interface Web do GitHub, pela inha de comando, CLI do GitHub ou Área de Trabalho do GitHub.
A primeira etapa é criar uma ramificação em seu repositório que não afete a ramificação padrão, e dar aos colaboradores a chance de revisar seu trabalho.
Para obter mais informações, confira "Como criar e excluir branches no 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 a fim de fazer backup de seu trabalho no 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 caso você adote uma abordagem diferente.
Qualquer pessoa que esteja colaborando com seu projeto poderá ver seu trabalho, responder a perguntas e fazer sugestões ou contribuições. Continue a criar, confirmar e enviar as alterações para sua ramificação até tudo estar pronto para a solicitação de feedback.
Dica
Você pode fazer uma ramificação separada para cada alteração para facilitar o feedback dos revisores ou para você entender as diferenças.
Quando tudo estiver pronto, você poderá criar uma solicitação de pull para pedir feedback aos colaboradores sobre suas alterações. Confira "Criar solicitação de pull."
A revisão de solicitação de pull é um dos recursos mais valiosos da colaboração. Você pode exigir aprovação de seus pares e equipes antes de mesclar as alterações. Além disso, você pode marcar as mudanças como um rascunho caso queira feedback ou aconselhamento antes de implementar as alterações.
Descreva a solicitação pull o máximo possível com as alterações sugeridas e explicando o 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. Confira "Sintaxe básica de formatação e gravação" e "Como vincular uma solicitação de pull a um problema."
Você também pode é usar a área de sessão de comentários para melhorar a qualidade e a documentação de PR, além de apontar algo explicitamente para os revisores. Além disso, também é possível @mention ou solicitar uma revisão de pessoas específicas de sua equipe.
Há ainda outras configurações, como solicitar automaticamente uma revisão de usuários específicos ou equipes quando uma solicitação de pull é criada ou fazer verificações em solicitações de pull em execução. Para saber mais, confira "Sobre as verificações de status" e "Sobre ramificações protegidas".
Após a validação dos comentários e verificações dos revisores, as alterações devem estar prontas para serem mescladas e as solicitações de pull prontas para aprovação. Confira Mesclar uma solicitação de pull".
Se você se deparar com conflitos, o GitHub informará você para que possa resolvê-los. "Como resolver conflitos de mesclagem."
Depois que uma solicitação de pull bem-sucedida é mesclada, não há necessidade de a ramificação remota permanecer. Você pode excluir sua ramificação para impedir que outras pessoas a s usem acidentalmente. Para obter mais informações, confira "Como excluir e restaurar branches em uma solicitação de pull".
Observação
Caso você precise restaurar ou reverter sua solicitação de pull, o GitHub manterá o histórico de confirmação e mesclagem.