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.

Criar uma pull request

Crie uma pull request para fazer sugestões e colaborar nas alterações de um repositório. Essas alterações são propostas em um branch, que garante que o branch-padrão só contém trabalho concluído e aprovado.

Neste artigo

Qualquer pessoa com permissões de leitura em um repositório pode criar uma pull request, mas você deve ter permissões de gravação para criar um branch. Se você quiser criar um branch para sua pull request e não tiver permissões de gravação no repositório, é possível bifurcar o repositório primeiro. Para obter mais informações, consulte "Criar uma pull request de uma bifurcação" e "Sobre bifurcações".

É possível especificar em qual branch você deseja fazer merge de suas alterações quando cria sua pull request. As pull requests só podem ser abertas entre dois branches que são diferentes.

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

Alterar o intervalo de branches e o repositório de destino

Por padrão, as pull requests são baseadas no branch padrão do repositório principal. Para obter mais informações, consulte "Sobre branches".

Se o repositório principal padrão não estiver correto, você poderá alterar o repositório principal e o branch com as listas suspensas. Também é possível trocar o head e os branches base com as listas suspensas para estabelecer diffs entre pontos de referência. As referências aqui devem ser nomes de branch no seu repositório do GitHub.

Branches de edição da pull request

Ao pensar em branches, lembre-se de que o branch base é onde as alterações devem ser aplicadas, o branch head contém o que você deseja que seja aplicado.

Quando você muda o repositório base, também muda as notificações para a pull request. Cada indivíduo que puder fazer push no repositório base receberá uma notificações de e-mail e verá a nova pull request no respectivo painel na próxima vez que se conectar.

Quando você muda qualquer uma das informações no intervalo de branches, as áreas de visualização de commit e arquivos alterados são atualizadas para mostrar o novo intervalo.

Dicas:

  • Usando a exibição de comparação, é possível configurar comparações entre períodos. Para obter mais informações, consulte "Comparando commits."
  • Os mantenedores de projeto podem adicionar um modelo de pull request para um repositório. Os modelos incluem solicitações de informações no texto de uma pull request. Para obter mais informações, consulte "Sobre modelos de problema e pull request".

Criar a pull request

Dica: Você também pode usar GitHub Desktop para criar uma pull request. Para obter mais informações, consulte “Criar um problema ou uma pull request" na documentação do GitHub Desktop.

  1. No GitHub Enterprise Server, navegue até a página principal do repositório.

  2. No menu "Branch", escolha o branch que contém seus commits.

    Menu suspenso Branch

  3. À direita do menu do Branch, clique em Novo pull request.

    link de "pul request" acima da lista de arquivos

  4. Use o menu suspenso do branch base para selecionar o branch em que deseja fazer merge de suas alterações. Em seguida, use o menu suspenso do branch de comparação para escolher o branch de tópico no qual você fez as alterações.

    Menus suspenso para escolher a base e comparar os branches

  5. Digite um título e uma descrição para a pull request.

    Título do pull request e campos de descrição

  6. Para criar um pull request que está pronto para revisão, clique em Criar Pull Request. Para criar um rascunho de pull request, use o menu suspenso e selecione Criar rascunho de pull request e, em seguida, clique em Rascunho de Pull Request. Para obter mais informações sobre pull requests em rascunho, consulte "Sobre pull requests".

    Botão de Criar pull request

Dica: Após criar uma solicitação de pull request, é possível pedir para uma pessoa específica revisar as alterações propostas. Para obter mais informações, consulte "Solicitar uma revisão de pull request".

Depois que a pull request tiver sido revisada, ela poderá sofrer merge no repositório.

Leia mais

Esse documento ajudou você?

Privacy policy

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.