Pular para o conteúdo

Como abrir um pull request de um fork no GitHub

Do botão Compare & pull request até a descrição que fecha a issue, o caminho completo.

Ferramenta relacionada

Passo a passo da primeira contribuição

Como abrir um pull request a partir de um fork?

Depois de enviar a branch para o seu fork, abra o repositório original e clique em Compare & pull request. Confira a base e o fork de origem, escreva título e descrição e clique em Create pull request.

O que é um pull request

Um pull request é o pedido para que quem mantém um repositório incorpore uma mudança que está em outra branch ou em outro fork. Ele junta o código, a conversa sobre o código e a revisão em um só lugar. Quando a mudança vem do seu fork, os dois lados têm nomes específicos na tela: o repositório base é o original, onde a mudança vai entrar; o fork de origem é o seu, onde a mudança está.

Antes de abrir

A Open Source Guides resume o preparo: faça o fork, crie uma branch, ligue o pull request às issues relacionadas, teste a mudança e, se ela altera a aparência, mostre capturas de tela de antes e depois. Siga o estilo do projeto, e revise com atenção qualquer texto ou código que uma ferramenta de IA tenha ajudado a escrever. Rode os testes que o CONTRIBUTING indicar.

Confira também o tamanho: um pull request pequeno e com um só assunto é mais fácil de revisar. O passo a passo da primeira contribuição leva você do fork até o git push; este guia começa daí.

Passo a passo no GitHub

Segundo a documentação do GitHub, depois de enviar a sua branch para o fork:

  1. Abra a página do repositório original. Aparece um aviso amarelo com o botão Compare & pull request.
  2. Se ele não aparecer, use compare across forks.
  3. No menu da branch base, escolha a branch do original que vai receber a mudança.
  4. No menu do fork de origem, escolha o seu fork e, em seguida, a sua branch.
  5. Escreva o título e a descrição.
  6. Em forks de contas pessoais, você pode marcar Allow edits from maintainers.
  7. Clique em Create pull request, ou use o menu ao lado para criar como rascunho.

O que escrever na descrição

Diga o que mudou, por que mudou e como conferir. Se a mudança resolve uma issue, escreva uma palavra de fechamento seguida do número: Closes #10. A documentação lista nove palavras que fecham a issue (close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved). Para uma issue de outro repositório, use Fixes dono/repo#100. Atenção: a issue só fecha sozinha quando o pull request vai para a branch padrão do repositório.

Rascunho e permissão de edição

Um pull request em rascunho (draft) sinaliza que o trabalho ainda não está pronto, mas você quer uma opinião. A documentação diz que, em organizações, alguns membros precisam pedir esse acesso a um dono. Sobre Allow edits from maintainers: se o seu fork tem workflows do GitHub Actions, o campo vira "Allow edits and access to secrets by maintainers", o que dá a quem mantém a chance de editar os workflows do seu fork e, com isso, acessar segredos e outras branches. Marque só se entender o que isso permite.

Exemplo resolvido: descrição de um pull request

Título: docs: corrige o link quebrado da seção de instalação

O link apontava para a página antiga do guia (https://exemplo.org/antigo).
Troquei pelo endereço atual e conferi que ele abre.

Como conferir: abra o README e clique no link da seção "Instalação".

Closes #42

Observe o formato: um título que já segue o padrão de mensagens do projeto, dois parágrafos curtos e a linha final que fecha a issue. Depois que o pull request está aberto, a revisão começa: veja como responder à revisão no passo a passo e como funciona o lado de quem avalia em revisar código dos outros.

Perguntas frequentes

O botão Compare & pull request não apareceu. E agora?

Segundo a documentação do GitHub, use a opção compare across forks na página do repositório original: escolha a branch base, o seu fork como fork de origem e a sua branch como branch de comparação. Depois escreva título e descrição.

Como fazer o pull request fechar uma issue sozinho?

Escreva na descrição uma das palavras close, closes, closed, fix, fixes, fixed, resolve, resolves ou resolved seguida do número, como Closes #10. A issue só fecha automaticamente se o pull request for para a branch padrão do repositório.

O que é um pull request em rascunho?

É um pull request marcado como ainda não pronto, criado pelo menu ao lado do botão Create pull request. Serve para pedir uma opinião antes de terminar. Em organizações, alguns membros precisam pedir esse acesso a um dono.

O que muda ao marcar Allow edits from maintainers?

Permite que quem mantém o projeto edite a sua branch. A documentação do GitHub avisa que, se o seu fork tem workflows do GitHub Actions, o campo vira Allow edits and access to secrets by maintainers, e quem mantém pode editar os workflows e acessar segredos e outras branches. Marque só se entender isso.

Fontes deste guia

Abertas em 11/10/2026. O texto é nosso, em português; as fontes ficam aqui com link, licença e o que foi lido.

  • Creating a pull request from a fork (GitHub Docs)
    A página não mostra data · aberta em · reconferência: confirmada na abertura (11/10/2026) · licença do conteúdo: CC BY 4.0 (conteúdo); MIT (código)
    O que lemos: O botão Compare & pull request, "compare across forks", repositório base e fork de origem, "Allow edits from maintainers" e o pull request em rascunho.
    Como usamos: Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso.
  • Linking a pull request to an issue (GitHub Docs)
    A página não mostra data · aberta em · reconferência: confirmada na abertura (11/10/2026) · licença do conteúdo: CC BY 4.0 (conteúdo); MIT (código)
    O que lemos: As palavras que fecham uma issue (close, closes, closed, fix, fixes, fixed, resolve, resolves, resolved), a sintaxe "Closes #10" e "Fixes dono/repo#100", e que só vale quando o pull request vai para a branch padrão.
    Como usamos: Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso.
  • How to Contribute to Open Source (Open Source Guides)
    A página não mostra data · aberta em · reconferência: confirmada na abertura (11/10/2026) · licença do conteúdo: CC BY 4.0
    O que lemos: Contribuir vai além de código; arquivos-chave (LICENSE, README, CONTRIBUTING, CODE_OF_CONDUCT); conferir licença, commits recentes e tom do projeto; quando abrir issue e quando abrir pull request; comunicação pública e objetiva; o que fazer depois de enviar (esperar cerca de uma semana antes de cobrar, responder a pedidos de mudança, pedir retorno se recusado).
    Como usamos: Texto próprio em português; os fatos e os comandos vêm da página, sem copiar trechos. Link e data em cada uso.

Informação geral, não é aconselhamento jurídico. Quando um guia cita uma licença de conteúdo, ela vale para a página citada, não para este site.