Contribuir em projetos open source é uma das coisas mais legais da área de desenvolvimento. Ano passado, senão me engano no Intercon WP do iMasters, rolou um FEMUG dentro do evento e, um dos temas abordados foi exatamente esse: a contribuição em projetos.
Muitas vezes (senão a maioria) é normal termos receio em contribuir em algum projeto pelo simples fato de achar que não podemos contribuir em nada com o que está ali. E foi exatamente aí que o FEMUG cutucou, incentivando a todos que estavam ali a começar a contribuir, seja com código, ou até mesmo revisão/tradução.
O processo
Pra quem já está acostumado, o processo de contribuição acaba se tornando automático. Já pra quem ainda está iniciando, algumas partes podem parecer confusas, mas aqui cito uma frase que ouvi do Daniel Filho que trabalha comigo na Netshoes que é a seguinte: “Tudo é mais fácil do que parece…”. E é verdade!
O processo de contribuição basicamente é o seguinte:
- Fork do projeto para o seu usuário.
- Clone do projeto forkado na sua máquina.
- Taca-le pau ..
- Atualização do seu projeto com o projeto original.
- Commitar e enviar suas alterações para o seu GitHub.
- Abrir um pull request para o projeto original.
Acho que é isso basicamente! Fazendo é muito mais fácil do que escrevendo (acredite!). Um item que me perdi um pouco logo quando comecei a contribuir em projetos foi o item 4. E é por isso que queria mostrar aqui rapidamente pra que outras pessoas possam pular essa parte que patinei no começo.
O cara upstream
Vamos supor que forkamos um projeto chamado 2015-rocks para nossa conta pessoal. Então nesse momento temos tanto o projeto original como o fork no mesmo ponto, idênticos.
Aí começamos a meter bronca no projeto local e fazemos um commit com essas alterações! Ao mesmo tempo, percebemos que no projeto original, um pull request foi aceito. Nesse ponto, os projetos já não são mais iguais; pelo contrário, eles se diferenciam bastante:
- o seu projeto local contém todas as mágicas novas que você adicionou;
- e a versão original do projeto agora tem uns paranauês novos que vieram do PR que foi aceito.
Se você enviar suas alterações para o Github e tentar fazer um pull request ele irá notificar que não é possível fazer o merge do repositório. Pra isso, precisamos atualizar nosso projeto local de acordo com a versão original. E é aí que entra o tal do upstream.
Digamos que você esteja contribuindo para este humilde blog (Valeu Julio Bitencourt pela dica) \o/
Adicionamos um remote com base na versão original do blog:
Após feito isso precisamos atualizar o upstream: $ git fetch upstream
Com o upstream atualizado, supondo que estamos no branch master do nosso projeto local, fazemos o merge:
Como lembrado pelo Lucas Mazza, aqui podemos também usar o rebase, evitando assim a mensagem do merge.
Agora caso queira atualizar seu repositório do Github com seu reposítório local antes de fazer suas mudanças e dar seu commit, fazemos:
Pronto! Agora nosso projeto local e remoto está sincronizado e atualizado com a versão original e, após enviar suas alterações para o GitHub, conseguimos fazer o pull request e torcer para ser aceito.