11.2.5 Criando um Pull Request a partir de um Fork no GitHub

Quando você contribui para um repositório no GitHub sem permissões de escrita, o processo envolve a criação de um fork – uma cópia do repositório no seu próprio perfil, como vimos anteriormente. A partir desse fork, você pode criar um branch, fazer suas alterações e, depois, propor que essas mudanças sejam incorporadas ao repositório original por meio de um Pull Request (PR).

Neste guia, vamos explorar o passo a passo para criar um PR a partir de um fork, garantindo que suas contribuições sejam enviadas corretamente para revisão e possível aprovação. O processo é muito parecido com o que vimos anteriormente em 10.3 Criando um Pull Request no GitHub.

Acessar a Página de Criação de Pull Request

Se o painel que indica que o branch aprendizCumbucaDev recebeu alterações recentemente (por exemplo, com a mensagem "aprendizCumbucaDev had recent pushes X minutes ago") ainda estiver visível, você pode iniciar um pull request rapidamente clicando no botão Compare & pull request (Comparar e pull request).

Se esse painel não estiver visível, outra opção é acessar diretamente a página do branch aprendizCumbucaDev. Para isso, clique no botão Contribute e, em seguida, selecione Open pull request (Abrir pull request).

Ambas as opções levam à mesma tela, onde você poderá revisar as alterações antes de criar o pull request.

Criar de Pull Request

Após clicar em um dos botões, a navegação será redirecionada para a página de criação do pull request. Nessa etapa, é importante revisar as mudanças, preencher os campos necessários e garantir que tudo esteja correto antes de enviar.

1. Certifique-se de que os repositórios e branches de origem e destino estão corretos

• O repositório e branch de origem devem ser:

  • aprendizCumbucaDev/PRimeiro-fork aprendizCumbucaDev

• O repositório e branch de destino devem ser:

  • cumbucadev/PRimeiro-fork main:

• Assim, a configuração correta será:

  • cumbucadev/PRimeiro-fork main ← aprendizCumbucaDev/PRimeiro-fork aprendizCumbucaDev

Isso garante que as alterações feitas no branch aprendizCumbucaDev do fork aprendizCumbucaDev/PRimeiro-fork serão enviadas para o branch main do repositório original cumbucadev/PRimeiro-fork.

2. Confira o Título

Como o pull request tem apenas um commit, o GitHub já preencheu o título com a mensagem deste commit. Certifique-se de que ele esteja claro e descritivo.

Neste caso, podemos prosseguir mantendo o título como Adiciona nova frase ao arquivo GARFO.md.

3. Preencha a Descrição

Na caixa de descrição, forneça um resumo das alterações e a motivação para elas.

Neste casp, preencha-a com:

# Adiciona nova frase ao arquivo GARFO.md

* **Descrição**: Adiciona a frase `Nem vem de garfo que hoje é dia de sopa.` ao arquivo **GARFO.md**.
* **Motivação**: Praticar fluxo de trabalho de **forks e pull requests**.

Não será necessário adicionar o número da issue, pois este repositório é utilizado apenas para fins didáticos e não requer criação de issues.

Também faça uma pré-visualização da descrição formatada para garantir que tudo está sendo exibido corretamente.

4. Revise as modificações

Antes de criar o PR, revise as mudanças para garantir que tudo está correto.

5. Crie o pull request

Após preencher todas as informações e revisar as mudanças, clique em Create pull request para enviar.

Parabéns, o seu primeiro pull request a partir de um fork foi criado com sucesso!

---

Para mais detalhes sobre criação de pull request a partir de um fork, consulte a Documentação Oficial do GitHub.

A seguir, vamos aprender sobre a sincronização de forks. Em seguida, abordaremos a revisão, mesclagem e as etapas pós-mesclagem do seu PR.