Como Criar um Pull Request (PR) no GitHub

 

Como Criar um Pull Request (PR) no GitHub

Um Pull Request (PR) é um recurso essencial no GitHub que permite propor mudanças em um repositório. É como se você estivesse dizendo: "Ei, eu fiz algumas alterações aqui, por favor, dê uma olhada e veja se você quer incluí-las no projeto principal."

Passo a passo para criar um PR:

1. Faça um Fork do Repositório:

   • O que é um fork? É uma cópia do repositório original em sua própria conta. Isso permite que você faça alterações sem afetar o repositório original.
   • Como fazer: Encontre o repositório que você deseja contribuir, clique no botão "Fork" no canto superior direito.

2. Clone o seu Fork para sua máquina:

   • Use o comando git clone para baixar o fork para o seu computador.
   • Exemplo: git clone https://github.com/seu_usuario/nome_do_repositorio.git

3. Crie um novo branch:

   • Por que um novo branch? Isolará suas alterações, permitindo que você trabalhe nelas sem afetar o branch principal do seu fork.
   • Como criar: Use o comando git checkout -b nome_do_seu_branch
   • Exemplo: git checkout -b feature-novo-funcionalidade

4. Faça suas alterações:

   • Edite os arquivos, adicione novos arquivos, etc.
   • Adicione as alterações ao staging: git add .
   • Faça um commit: git commit -m "Descrição clara das suas alterações"

5. Envie as alterações para o seu fork:

   • git push origin nome_do_seu_branch

6. Crie o Pull Request:

   • No GitHub, vá para o seu fork.
   • Você verá uma notificação sobre o novo branch. Clique nela.
   • Clique em "Compare & pull request".
   • Escreva uma descrição clara e concisa do seu PR, explicando o que você fez e por que.
   • Clique em "Create pull request".

Observações importantes:

• Revise seu PR: Antes de enviar, revise cuidadosamente suas alterações para garantir que tudo esteja funcionando como esperado.
• Seja claro na descrição: Uma boa descrição facilita a revisão do seu código e aumenta as chances de seu PR ser aceito.
• Esteja aberto ao feedback: Os mantenedores do projeto podem sugerir mudanças ou pedir mais informações. Seja receptivo a essas sugestões.
• Respeite as convenções do projeto: Cada projeto tem suas próprias convenções de estilo de código e diretrizes de contribuição. Certifique-se de segui-las.

Recursos adicionais:

• Documentação oficial do GitHub: https://docs.github.com/pt/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request