Enviar uma contribuição

Este tópico usa vários termos relacionados ao GitHub e a controle de versão. Se você não está familiarizado com os termos usados aqui, acesse os tópicos anteriores deste tutorial.

Estas são as etapas que você normalmente deve seguir para enviar uma contribuição para um projeto pelo GitHub:

1 Fork do projeto original (aquele com que você quer contribuir)
2 Clone do projeto originado pelo fork
3 Alterar o projeto localmente
4 Stage dos arquivos alterados
5 Commit dos arquivos alterados
6 Push dos arquivos alterados
7 Pull request das alterações
8 Aguardar análise do pull request

Quer mais detalhes de cada etapa? Confira o passo a passo na seção a seguir.

Passo a passo

Suponha que você quer contribuir com o projeto do TW Livre no GitHub. Isto é o que você precisa fazer:

  1. Faça o fork do projeto TW Livre. Isto vai fazer uma cópia do projeto para a sua própria conta do GitHub.
  2. Acesse o projeto do GitHub na sua conta do GitHub (obtido pelo fork) e faça o clone do repositório. Isto vai criar uma cópia local do projeto.
  3. Abra o projeto na sua cópia local e altere os arquivos como quiser. Pode ser uma correção, melhoria ou criação de novo conteúdo ou no site. Ao fazer qualquer alteração, os arquivos alterados ficarão com o status Add.
  4. Quando achar que as alterações estão prontas, faça um Stage dos arquivos alterados.
  5. Certifique-se de que as alterações estão concluídas e faça um Commit, indicando que você está pronto para enviá-las para a cópia remota do projeto.
  6. Faça um Push dos arquivos. Isto envia todas as alterações para a cópia remota na sua própria conta do GitHub.
  7. No GitHub, faça um pull request das alterações que você acabou de enviar pelo push. O pull request vai enviar as alterações que você fez no projeto da sua conta para o repositório da conta de origem (neste caso, o projeto original do TW Livre).
  8. A pessoa responsável pelo repositório de origem recebe o seu pull request e analisa as alterações. Aqui, essa pessoa normalmente toma uma das seguintes ações:
    • Ela decide que suas alterações estão corretas e são válidas. Então, ela faz o merge das alterações, incorporando-as ao projeto de origem.
    • Decide que suas alterações precisam de ajustes e sugere as correções. Então, você faz os ajustes e envia um novo pull request, que volta para o ciclo de aprovação.

Pronto! \o/ Você acabou de fazer a sua primeira contribuição em um projeto open-source.