Sobre pull requests
Observação: ao trabalhar com pull requests, lembre-se do seguinte:
- Se estiver trabalhando no modo de repositório compartilhado, é recomendável usar um branch de tópico para sua pull request. Embora você possa enviar pull requests de qualquer branch ou commit, com um branch de tópico, é possível fazer push de commits de acompanhamento caso seja preciso atualizar as alterações propostas.
- Ao fazer push de commits para uma pull request, não force o push. O push forçado pode corromper a pull request.
Após inicialização de uma pull request, você verá uma página de revisão que mostra uma visão geral de alto nível das alterações entre seu branch (o branch de comparação) e o branch base do repositório. É possível adicionar um resumo das alterações propostas, revisar as alterações feitas pelos commits, adicionar etiquetas, marcos e responsáveis, bem como fazer @menção a contribuidores individuais ou equipes. Para obter mais informações, consulte "Criar uma pull request".
Depois que tiver criado uma pull request, você poderá fazer push dos commits do branch de tópico para adicioná-los à sua pull request existente. Esses commits aparecerão em ordem cronológica na pull request e as alterações estarão visíveis na guia "Files chenged" (Arquivos alterados).
Outros contribuidores podem revisar as alterações propostas, adicionar comentários de revisão, contribuir com a discussão da pull request e, até mesmo, adicionar commits à pull request.
Quando estiver satisfeito com as alterações propostas, você poderá fazer merge da pull request. Se você está trabalhando em um modelo de repositório compartilhado, você cria uma pull request e, você ou outra pessoa, fará a mesclagem de suas alterações do seu branch de recurso no branch base que você especificar na sua pull request. Para obter mais informações, consulte "Fazer merge de uma pull request".
Se as verificações de status forem necessárias para um repositório, as verificações de status necessárias devem passar antes que você possa fazer merge do seu branch no branch protegido. Para obter mais informações, consulte "Sobre verificações de status obrigatórias".
You can link a pull request to an issue to automatically close the issue when someone merges the pull request. Para obter mais informações, consulte "Vincular um pull request a um problema."
Dicas:
- Para alternar entre as opções de recolhimento e expansão de todos os comentários de revisão desatualizados em uma pull request, mantenha pressionados opçãoAltAlt e clique em Mostrar desatualizados ou Ocultar desatualizados. Para ver mais atalhos, consulte "Atalhos de teclado".
- Você pode combinar commits por squash ao fazer merge de uma pull request para obter uma exibição mais simplificada das alterações. Para obter mais informações, consulte "Sobre merges da pull request".
É possível acessar seu painel a fim de encontrar rapidamente links para pull requests recentemente atualizadas nas quais você está trabalhando ou nas quais está inscrito. Para obter mais informações, consulte "Sobre seu painel pessoal".
Pull requests de rascunho
Draft pull requests are available in public repositories with GitHub Free for organizations and legacy per-repository billing plans, and in public and private repositories with GitHub Team, GitHub Enterprise Server 2.17+, and GitHub Enterprise Cloud.
Ao criar uma pull request, você pode optar por criar uma que já está pronta para revisão ou uma pull request de rascunho. Não é possível fazer merge das pull requests, e os proprietários do código não são solicitados automaticamente a revisar pull requests de rascunho. Para obter mais informações sobre como criar uma pull request de rascunho, consulte "Criar uma pull request" e "Criar uma pull request de uma bifurcação".
Quando você estiver pronto para receber feedback sobre seu pull request, você poderá marcar seu rascunho de pull request como pronto para revisão. Marcar um pull request como pronto para revisão irá solicitar revisões de qualquer proprietário de código. Você pode converter uma pull request em rascunho a qualquer momento. Para obter mais informações, consulte "Alterar o stage de uma pull request".
Diferenças entre commits em páginas de comparação e pull request
As páginas de comparação e pull request usam métodos diferentes para calcular o diff para os arquivos alterados:
- As páginas de comparação mostram a diferença entre a ponta do ref principal e o ancestral comum atual (ou seja, a base de merge) do ref principal e de base.
- As páginas de pull request mostram a diferença entre a ponta do ref principal e o ancestral comum do ref principal e de base no momento em que o pull request foi criado. Consequentemente, a base de merge utilizada para a comparação pode ser diferente.
Leia mais
- "pull request" no glossário do GitHub
- "Sobre branches"
- "Comentar em uma pull request"
- "Fazer merge de uma pull request"
- "Fechar uma pull request"
- "Excluir branches não utilizados"
- "Sobre merges de pull request"