Criando uma solicitação de pull a partir de um fork

É possível criar um pull request para propor alterações que você fez em um fork de um repositório original (upstream).

Quem pode usar esse recurso?

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

Se a sua solicitação de pull compara o seu branch de tópico com um branch do repositório upstream como branch base, então o seu branch de tópico também é 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 pull request, incluindo exemplos, confira Como criar uma solicitação de pull.

Observação

Para abrir uma pull request 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 pull request.

  1. Navegue até o repositório original onde você criou seu fork.

  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 para criar um novo pull request, clique em comparar entre forks.

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

  4. No menu suspenso de "ramificação base", selecione a ramificação do repositório upstream na qual deseja mesclar as alterações.

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

  5. No menu suspenso "fork de origem", selecione seu fork e depois use o menu suspenso "branch de comparação" para selecionar o branch no qual você fez suas 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.

Em breve será adicionado um novo recurso que permitirá aos mantenedores de repositórios usar forks de usuários ao criar solicitações de pull.

  1. 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 pull request, solicite a uma pessoa específica que revise suas alterações propostas. Para saber mais, confira Solicitando revisão de pull request.

Leitura adicional

  •         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks)

  •         [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/working-with-forks/allowing-changes-to-a-pull-request-branch-created-from-a-fork)