Criando uma pull request a partir de uma bifurcação

É possível criar uma pull request para propor alterações que você fez em uma bifurcação de um repositório upstream.

Quem pode usar esse recurso?

Anyone with write access to a repository can create a pull request from a user-owned fork.

Se sua solicitação de pull comparar o branch de tópico com um branch no repositório upstream como o branch base, o branch de tópico também será chamado de "branch de comparação" da solicitação de pull.

Por exemplo:

  • Sua ramificação de tópico (também conhecida como "ramificação de recurso") é a ramificação em que você está fazendo suas alterações em seu repositório bifurcado (por exemplo, my-topic-branch).
  • A ramificação base é a ramificação no repositório upstream (central) na qual você quer mesclar as alterações (por exemplo, main).
  • A solicitação de pull compara as alterações propostas pela ramificação de tópico (my-topic-branch) com a ramificação base (main), por isso my-topic-branch é conhecida como a "ramificação de comparação".

Para obter mais informações sobre os branches de solicitação de pull, incluindo exemplos, confira "Como criar uma solicitação de pull".

Observação: para abrir uma solicitação de pull em um repositório público, você precisa ter acesso de gravação no branch principal ou de origem ou, para repositórios pertencentes à organização, você precisa ser membro da organização que é o proprietário do repositório para abrir uma solicitação de pull.

  1. Navegue até o repositório original onde você criou sua bifurcação.

  2. Acima da lista de arquivos, na faixa amarela, clique em Comparação e solicitação de pull para criar uma solicitação de pull para o branch associado.

    Captura de tela da faixa acima da lista de arquivos.

  3. Na página usada para criar uma solicitação de pull, clique em Comparação entre forks.

    Captura de tela da página usada para abrir uma solicitação de pull. O link "Comparar forks" está contornado em laranja escuro.

  4. No menu suspenso "branch base", selecione o branch do repositório upstream no qual deseja mesclar as alterações.

    Captura de tela da página usada para abrir uma nova solicitação de pull. Os menus suspensos usados para escolher o repositório base e o branch estão contornados em laranja escuro.

  5. No menu suspenso "fork principal", selecione o fork e use o menu suspenso "branch de comparação" para selecionar o branch no qual você fez alterações.

    Captura de tela da página usada para abrir uma nova solicitação de pull. Os menus suspensos usados para escolher o repositório principal e o branch de comparação estão contornados em laranja escuro.

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

  7. Nos forks de propriedade do usuário, caso você deseje permitir que qualquer pessoa com acesso de push no repositório upstream faça alterações na sua solicitação de pull, selecione Permitir edições de mantenedores.

    Aviso: se o fork contiver fluxos de trabalho do GitHub Actions, a opção será Permitir edições e acesso aos segredos por mantenedores. Permitir edições no branch de uma bifurcação que contém fluxos de trabalho do GitHub Actions também permite que um mantenedor edite os fluxos de trabalho do repositório bifurcado, o que pode potencialmente revelar valores de segredos e conceder acesso a outros branches.

  8. Para criar uma solicitação de pull pronta para revisão, clique em Criar Solicitação de Pull. Para criar uma solicitação de pull de rascunho, use o manu suspenso, selecione Criar Solicitação de Pull de Rascunho e clique em Solicitação de Pull de Rascunho. Se você for membro de uma organização, talvez seja necessário solicitar acesso a pull requests de rascunho a um proprietário da organização. Confira "Sobre solicitação de pull".

Dica: depois de criar uma solicitação de pull, solicite a uma pessoa específica que revise suas alterações propostas. Para obter mais informações, confira "Solicitar revisão de pull request".

Leitura adicional