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.
Tenha muito cuidado quando fizer push forçado de commits para um pull request. Faz push forçado das alterações no histórico do repositório e pode corromper o seu pull request. Se outros colaboradores fizerem o branch do projeto antes de um push forçado, este poderá substituir os commits nos quais os colaboradores basearam o seu trabalho.

Você pode criar pull requests no GitHub.com, com GitHub Desktop, em Codespaces, em GitHub Mobile e ao usar a CLI do GitHub.

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 branches protegidos."

You can link a pull request to an issue to show that a fix is in progress and to automatically close the issue when someone merges the pull request. For more information, see "Linking a pull request to an issue."

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

Rascunhos de pull requests estão disponíveis em repositórios públicos com GitHub Free para organizações e planos de cobrança de legados por repositório, e em repositórios públicos e privados com GitHub Team, GitHub Enterprise Server 2. 7+ e 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 um 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.

Sobre pull requests

Neste artigo