É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está a colaborar, errar não é algo agradável. Mas open source (código aberto) trata-se de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores open source aprendem e contribuem pela primeira vez.
Ler artigos e ver tutoriais pode ajudar, mas nada melhor do que realmente "pôr a mão na massa" sem estragar nada. Este projeto visa simplificar a forma com que os novatos fazem a sua primeira contribuição. Lembra-te: quanto mais relaxado(a) estiveres, melhor aprenderás. Se quiseres fazer a tua primeira contribuição, segue os passos abaixo. Nós prometemos, será divertido.
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png"alt="fork deste repositorio" />
Se ainda não tens o git na tua máquina, instala-o aqui.
Faz um Fork ao clicares no botão "Fork" no topo desta página. Isto vai criar uma cópia deste repositório na tua conta.
Agora clone este repositório para a tua máquina. Carrega no botão "Clone or download" e, em seguida, clica no ícone "Copy to clipboard" para copiar a URL.
Abre o teu terminal e executa o comando seguinte:
git clone "url que copiou"
onde "url que copiou" (sem as aspas) é a URL deste repositório. Consulta as etapas anteriores para obter a URL.
Por exemplo:
git clone https://github.com/este-eh-voce/first-contributions.git
onde "este-eh-voce" é o seu usuário do GitHub. Aqui estas a copiar o conteúdo do repositório first-contributions para o teu computador.
Vá para o diretório do repositório no teu computador (caso ainda não estejas lá):
cd first-contributions
Agora cria um Branch usando o comando git checkout:
git checkout -b <add-seu-nome>
Por exemplo:
git checkout -b add-alonzo-church
Obs.: O nome do Branch não precisa de ter a sigla "add", mas neste caso é recomendável, porque a finalidade deste Branch é a de adicionar o teu nome a uma lista.
Agora abre o ficheiro Contributors.md no teu editor de código, adiciona o teu nome nele e guarda o ficheiro. Se fores para o diretório do projeto e executar o comando git status, verás que há alterações. Adiciona essas alterações ao Branch que acabaste de criar utilizando o comando git add:
git add Contributors.md
Agora faz um Commit dessas alterações utilizando o comando git commit:
git commit -m "Add <Teu-nome> to Contributors list"
preenche <Teu-nome> com o teu nome ou nickname.
Faz um Push utilizando o comando git push:
git push origin <add-teu-nome>
substitui <add-teu-nome> pelo nome do Branch que criaste anteriormente.
Se fores para o teu repositório no GitHub, verás um botão Compare & pull request. Clica nesse botão.
Agora envia um Pull Request.
Logo estarei a incorporar as tuas mudanças no Branch principal (master) deste projeto. Vais receber um e-mail de notificação quando as alterações forem incorporadas.
Celebra as tuas contribuições e partilha-as com amigos e seguidores através da web app.
Podes também juntar-te à nossa equipa no Slack caso precises de alguma ajuda ou tenhas alguma dúvida. Junta-te à nossa equipa no Slack.
Aqui estão alguns repositórios com Issues a nível de principiante em que tu podes ajudar a resolver. Vai em frente e clica nos repositórios para saber mais.
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |