Visão Geral de Pull Requests
Esta página explica como pull requests (PRs) funcionam, como criá-los e gerenciá-los, e as melhores práticas para colaboração e revisão.
Pull Requests permitem mesclar atualizações de um branch de origem para um branch de destino. Eles suportam revisão de código, detecção de conflitos e garantem que as alterações sejam aprovadas antes de serem integradas.
PRs são centrais para a colaboração, ajudando as equipes:
Revisar alterações antes de mesclar
Detectar e resolver conflitos cedo
Manter um histórico de release limpo
⚠️ Importante: Sempre valide e resolva conflitos antes de mesclar para evitar sobrescrever alterações críticas.
Como Criar um Pull Request
Você pode abrir a Criar Pull Request tela de duas maneiras:
A partir da aba Pull Requests → clique em Criar pull request.
A partir da aba Código do Branch → clique no menu ⋮ → selecione Criar pull request.
Etapas
Selecione um Branch de destino (onde as alterações serão mescladas).
Selecione um Branch de origem (onde as alterações existem).
Insira um nome para o pull request.
Adicione uma descrição resumindo as alterações.
Atribua revisores (opcional, mas recomendado).
Clique Criar.
Página de Visão Geral do Pull Request
A página de visão geral do Pull Request fornece um instantâneo detalhado de cada solicitação. A partir daqui, você pode:
Visualizar o título e ID do PR.
Ver o caminho de merge (branch de origem → branch de destino).
Verifique a status (Criado, Revisão Solicitada, Alterações Solicitadas, Aprovado, Fechado).
Identificar o autor e os revisores atribuídos.
Acompanhar a atividade mais recente incluindo carimbos de data/hora.
Acessar ações pelo menu ⋮:
Editar – atualizar o nome, a descrição ou o branch de destino do PR.
Fechar – encerrar o PR sem mesclar.
Esta visualização é o hub central para acompanhar o progresso e decidir se um PR está pronto para mesclar.
Visualização de Lista de Pull Requests
Ao visualizar a página de Pull Requests, você pode usar filtros e ver colunas principais.
Pesquisar – procurar por nome ou ID do PR.
Autores – filtrar por criador do PR.
Status – filtrar por estado (Criado, Revisão Solicitada, Alterações Solicitadas, Aprovado).
Revisores – filtrar por revisores atribuídos.
Atividade Mais Recente – ordenar pull requests por:
Ordenar por nome A–Z – ordem alfabética.
Ordenar por nome Z–A – ordem alfabética inversa.
Atividade mais recente – atualizações mais recentes primeiro.
Atividade mais antiga – atualizações mais antigas primeiro.
Intervalo de Datas – filtrar por período de criação ou atualização.
Colunas de Pull Request
ID & Título – número e nome do PR.
Caminho do Branch – direção do merge (por exemplo, Feature → ReleaseBranch).
Status – estado atual do PR.
Autor – quem criou o PR.
Revisores – revisores atribuídos.
Atividade Mais Recente – detalhes da última atualização.
Ações (⋮) – editar, revisar ou fechar um pull request.
Status dos Pull Requests
Criado – PR aberto mas ainda não revisado.
Revisão Solicitada – aguardando que os revisores verifiquem e forneçam feedback.
Alterações Solicitadas – revisores solicitaram modificações antes da aprovação.
Aprovado – PR foi aprovado e está pronto para mesclar.
Fechado – PR foi fechado sem ser mesclado.
Editando um Pull Request
Na página de Pull Requests, clique no ⋮ menu ao lado do PR.
Selecione Editar.
Atualize o branch de destino, nome, ou descrição.
Clique Salvar.
Fechando um Pull Request
Na página de Pull Requests, clique no ⋮ menu ao lado do PR.
Selecione Fechar.
Um diálogo de confirmação aparece: “Tem certeza de que deseja fechar este pull request?”
Clique Sim para confirmar.
Exemplo
Mesclar Feature-02 em ReleaseBranch-01 garante que a nova funcionalidade seja revisada e testada antes do lançamento. Os revisores podem solicitar alterações, resolver conflitos e aprovar antes que a mesclagem seja finalizada.
Melhores práticas
Sempre abra um PR antes de mesclar branches de funcionalidade ou correção de bugs.
Escreva títulos e descrições claros para os revisores.
Atribua pelo menos um revisor para responsabilidade.
Resolva conflitos no PR antes de mesclar.
Feche PRs obsoletos para manter a lista limpa.
Atualizado