Aqui, explicaremos como fazer uma contribuição usando git na linha de comando do Unix.
Depois de quer criado a sua conta gratuita no GitHub, faça um fork desse projeto. O que é um fork? Fork é como se fosse uma cópia desse repositório para sua conta. Dessa forma, você consegue modificar o código livremente sem causar problemas no código original.
Para fazer um fork, clique aqui no botão no "fork" no topo da página:
Nesse caso, meu usuário se chama ebonet. Agora você posso acessar seu repositório em github.com/seuusuario/git-basics.
Observe que embaixo do nome do projeto já é informado que o repositório na verdade é um fork de um outro. Para acessar o seu repositório, basta trocar ebonet pelo seu nome de usuário.
Depois do passo 1, você tem uma cópia do repositório totalmente sua, mas como editá-la? Para isso, você precisa clonar o projeto, ou seja, copiar para o seu computador. Para isso, digite os seguintes comandos:
git clone http://github.com/{seuusuario}/git-basics
cd git-basics
Agora que você tem uma cópia local, você consegue editar o conteúdo.
- Abra o arquivo README.md. No final dele, existe uma lista de usuários.
- Adicione ao final da lista (não se esqueça de deixar um item em branco no final):
* [seuusuario](github.com/seuusuario) - comando
No git, temos pontos ao longo do projeto que consideramos importantes, como por exemplo ter implementado
uma feature nova, uma correção de bug ou alguma melhoria qualquer. A esses pontos na história damos o nome
de commit.
Quando você adicionou seu nome na lista, você simplesmente
Na pasta raiz do projeto, digite
git status
Se tudo der certo, você verá que apenas o README.md foi modificado:
Agora digite
git commit -am "Usuário adicionado ao README.md"
Um commit diz para o git que aquele é um ponto importante no projeto, indica um progresso. Porém, esse commit por enquanto só está salvo localmente. Para mandá-lo ao servidor, digite:
git push
Agora acesse a sua versão do repositório (github.com/seuusuario/git-basics), abra o arquivo README.md no site
e você verá sua alteração ali \o/.
As alterações estam salvas online, porém elas foram feitas apenas no seu espelho do repositório original, nada foi adicionado ao repo original do CodeForFloripa. Para fazer isso, você precisa criar um PullRequest, que é um pedido para que os membros do time aceitem sua contribuição. Para criar um PullRequest:
- Acesse o repo original
- Clique em
New Pull Request - Clique em
Compare Across Forks - Selecione o seu repositório
- Clique em
Create Pull Request - Adicione uma mensagem explicando o motivo do PullRequest e o que foi feito.
- Clique em
Confirm
Pronto! Agora é só esperar um membro da equipe verificar sua constribuição e adicioná-la ao repositório principal.