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 sugeridas em um branch, garantindo que o branch "master" contenha apenas trabalho finalizado e aprovado.

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.

Note: To open a pull request in a public repository, you must have write access to the head or the source branch or, for organization-owned repositories, you must be a member of the organization that owns the repository to open a pull request.

You can close corresponding issues using a keyword in your pull request or commit message. For more information, see "Closing issues using keywords."

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.

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 "Comparar commits ao longo do tempo".
  • 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

  1. On GitHub, navigate to the main page of the repository.

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

    Menu suspenso Branch

  3. To the right of the Branch menu, click New pull request.

    Pull Request button

  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. Type a title and description for your pull request.

    Pull request title and description fields

  1. To create a pull request that is ready for review, click Create Pull Request. To create a draft pull request, use the drop-down and select Create Draft Pull Request, then click Draft Pull Request. For more information about draft pull requests, see "About pull requests."
    Create pull request button

Tip: After you create a pull request, you can ask a specific person to review your proposed changes. For more information, see "Requesting a pull request review."

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

Leia mais

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato