Criar uma pull request

Crie um 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.

Anyone with read access to a repository can create a pull request.

Caso deseje criar um novo branch para seu pull request e não tenha permissões de gravação no repositório, você pode 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.

Você pode vincular um pull request a um problema para mostrar que uma correção está em andamento e para fechar automaticamente o problema quando alguém fizer merge do pull request. Para obter mais informações, consulte "Vincular um pull request a um problema."

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

  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. Above the list of files, click 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.

Para saber mais sobre GitHub CLI, consulte "Sobre GitHub CLI."

Para criar um pull request, use o subcomando gh pr create.

gh pr create

Para atribuir uma pull request a uma pessoa, use os sinalizadores --assignee ou -a. Você pode usar @me para autoatribuir o pull request.

gh pr create --assignee "@octocat"

Para especificar o branch no qual você deseja fazer merge do pull request, use os sinalizadores --base ou -B. Para especificar o branch que contém commits para o seu pull request, use os sinalizadores --head ou -H.

gh pr create --base my-base-branch --head my-changed-branch

Para incluir um título e texto do novo pull request, use os sinalizadores de --title e --body.

gh pr create --title "The bug is fixed" --body "Everything works again"

Para marcar uma pull request como rascunho, use o sinalizador --draft.

gh pr create --draft

Para adicionar etiquetas ou marcos ao novo pull request, use os sinalizadores --label e --milestone.

gh pr create --label "bug,help wanted" --milestone octocat-milestone

Para adicionar o novo pull request a um projeto específico, use o sinalizador --project.

gh pr create --project octocat-project

Para atribuir um indivíduo ou equipe como revisores, use o sinalizador --reviewer.

gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name

Para criar um pull request no navegador padrão, use o sinalizador --web.

gh pr create --web
  1. Alterne para o branch para o qual você deseja criar um pull request. Para obter mais informações, consulte "Alternar branches".
  2. Clique em Create Pull Request (Criar pull request). GitHub Desktop abrirá o seu navegador-padrão para levar você a GitHub. O botão Criar Pull Request
  3. Em GitHub, confirme se o branch no menu suspenso base: é o branch onde você deseja fazer merge das suas alterações. Confirme se o branch no menu suspenso compare: é o branch de tópico em que você fez suas alterações. Menus suspenso para escolher a base e comparar os branches
  4. Digite um título e uma descrição para a pull request. Título do pull request e campos de descrição
  5. 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
  1. Alterne para o branch para o qual você deseja criar um pull request. Para obter mais informações, consulte "Alternar branches".
  2. Clique em Create Pull Request (Criar pull request). GitHub Desktop abrirá o seu navegador-padrão para levar você a GitHub. O botão Criar Pull Request
  3. Em GitHub, confirme se o branch no menu suspenso base: é o branch onde você deseja fazer merge das suas alterações. Confirme se o branch no menu suspenso compare: é o branch de tópico em que você fez suas alterações. Menus suspenso para escolher a base e comparar os branches
  4. Digite um título e uma descrição para a pull request. Título do pull request e campos de descrição
  5. 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

Leia mais

Esse documento ajudou você?

Política de Privacidade

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.