Como fazer pull request no GitHub
Passo 1: Fork do projeto
O primeiro passo é fazer um fork do projeto que você deseja contribuir. Para isso, acesse a página do projeto no GitHub e clique no botão "Fork".
Passo 2: Clonagem do projeto
Após fazer o fork, você precisa clonar o projeto na sua máquina. Para isso, abra um terminal e execute o seguinte comando:
git clone https://github.com/seu-usuário/seu-projeto.git
Passo 3: Criação de uma branch
Em seguida, crie uma branch para realizar as alterações. Para isso, execute o seguinte comando:
git checkout -b minha-branch
Passo 4: Realização das alterações
Faça as alterações necessárias nos arquivos do projeto.
Passo 5: Commit das alterações
Após realizar as alterações, commite-as. Para isso, execute o seguinte comando:
git commit -am "Descrição das alterações"
Passo 6: Push das alterações
Em seguida, pushe as alterações para o seu repositório fork. Para isso, execute o seguinte comando:
git push origin minha-branch
Passo 7: Criação do pull request
Por fim, crie um pull request para mesclar as alterações do seu repositório fork para o repositório original. Para isso, acesse a página do projeto no GitHub e clique no botão "New pull request".
Descrição do pull request
Na descrição do pull request, é importante incluir as seguintes informações:
- Um título claro e conciso que resuma as alterações feitas.
- Uma descrição detalhada das alterações feitas.
- Quaisquer testes ou verificações que foram realizadas para garantir que as alterações funcionem corretamente.
Atribuição de revisores
Você também pode atribuir revisores para o seu pull request. Isso é útil para obter feedback de outros desenvolvedores antes de mesclar as alterações.
Aprovação do pull request
Depois que o seu pull request for aprovado, as alterações serão mescladas para o repositório original.
Exemplo de pull request
Aqui está um exemplo de pull request:
Título: Corrige um bug no código
Descrição:
Este pull request corrige um bug no código que fazia com que o programa travasse. O bug foi corrigido adicionando uma verificação adicional para verificar se um valor é válido.
Testes:
Foram realizados testes para garantir que as alterações funcionem corretamente. Os testes podem ser encontrados no arquivo tests.py
.
Atribuição de revisores:
@[usuário do GitHub]
Comentários:
Agradeço o seu feedback. As alterações foram mescladas com sucesso.
Conclusão
Com esses passos, você poderá fazer pull request no GitHub para contribuir com projetos open source.