Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Sobre pull requests

As pull requests permitem que você informe outras pessoas sobre as alterações das quais você fez push para um branch em um repositório no GitHub. Depois que uma pull request é aberta, você pode discutir e revisar as possíveis alterações com colaboradores e adicionar commits de acompanhamento antes que as alterações sofram merge no branch base.

Neste artigo

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.

Você pode ver informações sobre o status da implantação atual do branch e atividades passadas de implantação na guia "Conversation" (Conversa). Para obter mais informações, consulte "Exibir atividade de implantação para um repositório".

Quando estiver satisfeito com as alterações propostas, você poderá fazer merge da pull request. Se estiver trabalhando em um modelo de repositório compartilhado, as alterações propostas sofrerão merge do branch head para o branch base que foi especificado na pull request. Para obter mais informações, consulte "Fazer merge de uma pull request".

If status checks are required for a repository, the required status checks must pass before you can merge your branch into the protected branch. Para obter mais informações, consulte "Sobre verificações de status obrigatórias".

You can close corresponding issues using a keyword in your pull request or commit message. Para obter mais informações, consulte "Fechar problemas usando palavras-chave".

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 pressionada a tecla alt e clique em Show outdated (Mostrar desatualizados) ou Hide outdated (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, GitHub Pro, and legacy per-repository billing plans, and in public and private repositories with GitHub Team and GitHub Enterprise Cloud. For more information, see "GitHub's products."

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

When you're ready to get feedback on your draft pull request, you can mark your pull request as ready for review. If the author is unavailable for any reason, anyone with write access to the repository can mark the pull request as ready for review. Then, the pull request can be merged, and code owners will be requested to review the pull request. Para obter mais informações, consulte "Alterar o stage de uma pull request".

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato