É 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.
Ler em outros idiomas
Se não possui o git em sua máquina, instale-o 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-e-voce/first-contributions.git
onde "este-e-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 | 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.