Fluxo de pull requests no GitHub

Uma Solicitação de incorporação (PR) é uma proposta para mesclar uma ramificação a outra. No GitHub, ela cria uma discussão na qual os colegas revisam o código, deixam comentários, solicitam alterações e, por fim, aprovam a mesclagem.

Depois de enviar uma ramificação de funcionalidade ao GitHub, aparece uma faixa amarela oferecendo a opção de comparar e criar uma PR. Clique nela ou acesse Solicitações de incorporação → Nova solicitação de incorporação e selecione suas ramificações.

Uma boa descrição de PR explica: o que mudou e por quê. Inclua uma captura de tela para alterações na interface. Inclua um link para o problema relacionado. Descreva como você testou a alteração. O leitor não deveria precisar ler o código para entender a intenção.

Designe colegas específicos como revisores. Eles recebem uma notificação e podem aprovar, solicitar alterações ou comentar. A maioria das equipes exige pelo menos uma aprovação antes da mesclagem.

Os comentários aparecem em linha nas linhas alteradas. Os revisores podem pedir esclarecimentos, sugerir uma abordagem diferente ou aprovar. Responda a cada comentário — seja com uma alteração no código, seja com um motivo para não alterá-lo.

Quando um revisor solicita alterações, envie novas confirmações para a mesma ramificação. A PR é atualizada automaticamente. Resolva cada conversa clicando em 'Resolver conversa' depois de atendê-la.

Abra uma PR como Rascunho para indicar que ela é um trabalho em andamento. PRs em rascunho ainda permitem revisão e discussão, mas não podem ser mescladas acidentalmente. Converta-a em Pronta quando estiver concluída.

Quando a ramificação principal avançar durante a revisão, reorganize sua ramificação sobre a ramificação principal mais recente para evitar conflitos e garantir que suas alterações funcionem com o código novo.

O GitHub oferece três estratégias de mesclagem: Confirmação de mesclagem (preserva todas as confirmações), Compactar e mesclar (uma confirmação por PR, com histórico principal limpo) e Reorganizar e mesclar (linear, sem confirmação de mesclagem). As equipes geralmente escolhem uma estratégia para manter a consistência.

Proteja a ramificação principal exigindo revisão de PR, exigindo que as verificações de status sejam aprovadas (CI) e proibindo envios diretos. Configure isso em GitHub → Configurações → Ramificações.

Mantenha as PRs pequenas e focadas. Uma PR por funcionalidade ou correção. PRs grandes são difíceis de revisar. Responda aos comentários de revisão em até um dia. Agradeça aos revisores. Seja gentil — a revisão de código é uma oportunidade de ensino, não uma auditoria.

O que uma boa descrição de PR deve incluir?

Envie a ramificação de funcionalidade → abra uma PR com uma descrição clara → solicite revisores → atenda ao feedback com novas confirmações → mantenha a ramificação atualizada com reorganização → obtenha aprovação → mescle. Mantenha as PRs pequenas, focadas e bem descritas. As regras de proteção de ramificações garantem a qualidade na ramificação principal.