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.
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".
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 link a pull request to an issue 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
Draft pull requests are available in public repositories with GitHub Free for organizations and legacy per-repository billing plans, and in public and private repositories with GitHub Team, GitHub Enterprise Server 2.17+, and 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".
When you're ready to get feedback on your pull request, you can mark your draft pull request as ready for review. Marking a pull request as ready for review will request reviews from any code owners. Você pode converter uma pull request em rascunho a qualquer momento. Para obter mais informações, consulte "Alterar o stage de uma pull request".
Leia mais
- "pull request" no glossário do GitHub
- "Sobre branches"
- "Comentar em uma pull request"
- "Fazer merge de uma pull request"
- "Fechar uma pull request"
- "Excluir branches não utilizados"
- "Sobre merges de pull request"