O que é um pull request
Pull request é uma proposta, organizada por uma plataforma de colaboração, para incorporar mudanças de uma branch em outra. Ela reúne a comparação dos arquivos, a descrição da alteração e a discussão sobre o trabalho.
Você pode usá-lo para explicar uma correção, receber comentários e acompanhar verificações antes da integração. Sua existência não comprova que houve revisão nem que o conteúdo foi aceito.
Origem e destino delimitam a proposta
A branch de origem contém o trabalho proposto, enquanto a base indica onde você pretende incorporá-lo. Uma base incorreta pode fazer a comparação incluir mudanças que não pertencem à tarefa.
Confira esses dois lados e descreva o comportamento que será alterado. Uma explicação útil permite relacionar o problema, os arquivos modificados e a forma de verificar o resultado.
A proposta acompanha novas revisões
Commits enviados à branch de origem normalmente atualizam o mesmo pull request. Enquanto isso, a branch de destino pode avançar por outras mudanças e alterar as condições da futura integração.
Confira se os testes aprovados correspondem ao conteúdo atual da proposta. Comentários podem apontar para versões anteriores do arquivo, então confira se o ajuste solicitado ainda corresponde ao trecho apresentado.
Revisão e verificações têm alcances diferentes
Um teste automatizado examina os casos configurados, enquanto a revisão pode identificar escopo incorreto ou uma hipótese que o teste não cobre. Os dois resultados precisam ser relacionados à revisão que será integrada.
Uma proposta em rascunho permite discutir o trabalho ainda incompleto. No GitHub, ela não pode ser integrada enquanto permanecer nesse estado. A descrição deve distinguir o que já funciona do que falta implementar ou conferir, para que a revisão considere o alcance apresentado.
Incorporar ou encerrar a proposta
A plataforma pode oferecer commit de merge, squash ou rebase, com efeitos diferentes sobre o histórico. Encerrar o pull request sem integrar mantém a discussão registrada, mas não incorpora automaticamente seus arquivos ao destino.
A branch e a comparação dos arquivos ajudam a entender o conteúdo apresentado. Depois da integração, confira o estado produzido e as verificações correspondentes, principalmente quando houve resolução de conflitos ou mudanças adicionais.
Dúvidas frequentes
Perguntas frequentes sobre Pull request
- Pull request é um comando básico do Git?
- Não. O Git não oferece um comando chamado pull request. Plataformas como GitHub organizam a comparação entre branches, a revisão e as verificações antes da integração.
- Abrir um pull request altera a branch de destino?
- A abertura, sozinha, não incorpora o trabalho. A branch de destino pode continuar recebendo outras mudanças enquanto a proposta está em revisão.
- Novos commits entram no mesmo pull request?
- Em geral, novos commits enviados à branch de origem atualizam a proposta aberta. Isso pode exigir novas verificações e revisão do conteúdo acrescentado.
- Aprovar equivale a executar o merge?
- Não. A aprovação é um resultado da revisão. A integração depende das condições e permissões da plataforma, podendo usar merge, squash ou rebase conforme a configuração.
Para continuar
Recursos relacionados
Documentação
GitHub: pull requests
Origem, destino e revisão de uma proposta de mudança.
Abrir recursoDocumentação
GitHub: formas de integração
Diferenças entre merge, squash e rebase na plataforma.
Abrir recursoAplicação na formação
Developer Workspace
O pull request reúne uma proposta de alteração, comentários e verificações para orientar sua integração ao repositório.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.