É difícil. Sempre é difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, errar não é algo agradável. Mas open source (código aberto) se trata 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. Lembre-se: quanto mais relaxado você estiver, melhor aprenderá. Se quiser fazer a sua primeira contribuição, siga os passos abaixo. Nós prometemos, será divertido.
Se não possui o git em sua máquina, instale aqui.
Faça um Fork clicando no botão "Fork" no topo desta página. Isto irá criar uma cópia deste repositório na sua conta.
Agora clone este repositório para a sua máquina. Clique no botão "Clone or download" e, em seguida, clique no ícone "Copy to clipboard" para copiar a URL.
Abra o seu terminal e execute o seguinte comando do git:
git clone "url que copiou"
onde "url que copiou" (sem as aspas) é a URL deste repositório. Consulte 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 você está copiando o conteúdo do repositório first-contributions para o seu computador.
Vá para o diretório do repositório no seu computador (caso você não esteja lá):
cd first-contributions
Agora crie 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 ter a sigla "add", mas nesse caso é recomendável, porque a finalidade deste Branch é a de adicionar o seu nome a uma lista.
Agora abra o arquivo Contributors.md em seu editor de código, adicione o seu nome a ele e salve o arquivo. Se você for para o diretório do projeto e executar o comando git status, verá que há alterações. Adicione essas alterações ao Branch que você acabou de criar utilizando o comando git add:
git add Contributors.md
Agora faça um Commit dessas alterações utilizando o comando git commit:
git commit -m "Add <seu-nome> to Contributors list"
preenchendo <seu-nome> com o seu nome.
Faça um Push utilizando o comando git push:
git push origin <add-seu-nome>
substituindo <add-seu-nome> pelo nome do Branch que você criou anteriormente.
Se você for para o seu repositório no GitHub, verá um botão Compare & pull request. Clique nesse botão.
Agora envie um Pull Request.
Logo estarei mesclando as suas mudanças no Branch principal (master) deste projeto. Você receberá um e-mail de notificação quando as alterações forem mescladas.
 |
 |
 |
|---|---|---|
| [GitHub Desktop](../(github-desktop-tutorial.md) | Visual Studio 2017 | GitKraken |
Você tambem pode se juntar a nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. Junte-se a nossa equipe no Slack.
Aqui estão alguns repositórios com Issues a nível de iniciante que você poderia resolver. Vá em frente e clique nos repositórios para saber mais.
