Blog do Elomar França

Esse post ensina a colaborar com um projeto no Github. Antes de seguir, é bom que você aprenda git, crie uma conta no Github e configure sua chave SSH. Pronto? Então vamos lá.

A gente vai usar como exemplo o projeto Aprendendo Rails, que foi criado pro pessoal do grupo Aprendendo Rails começar a “brincar” com Git e Github.

O primeiro passo é criar um fork do projeto no Github - criar uma “ramificação”, um projeto nosso baseado no que a gente quer colaborar. Basta - logado no github - ir na página do projeto e dar um fork. Isso vai criar o projeto <seulogin>/aprendendorails com todo o conteúdo e histórico de logins do original.

Segundo passo é clonar o seu projeto, pra poder trabalhar nele.

~$ git clone git@github.com:elomar/aprendendo-rails.git

Agora, fluxo normal de trabalho. Edite os arquivos e faça seus commits.

… (trabalhando) …

Pronto? Agora é hora de mandar as alterações de volta.

Como nós não podemos mandar direto pro projeto original, já que não somos colaboradores, vamos mandar as alterações pro nosso projeto:

~/aprendendo-rails$ git push

Pronto. Seu projeto já está atualizado no Github. Vá na página do seu projeto e dê um “pull request”, pra pedir ao dono do projeto original e quem mais fez fork dele que aplique (faça um pull) das alterações que você fez.

Se você é colaborador do projeto, a coisa é mais fácil ainda.

Você pode adicionar o repositório original como um remote:

~/aprendendo-rails$ git remote add [nome] git://github.com/caironoleto/aprendendo-rails.git

E dar “push” e “pull” direto na fonte:

~/aprendendo-rails$ git pull [nome] [branch] // git pull cairo-noleto master

Voilà! Você colaborou com o projeto!

Uma sugestão. Agora que você já sabe como colaborar no Github, ao trabalho: Escolha um projeto open source
por lá, resolva uns bugs dele/incremente algumas coisas. Colabore!