É 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 o que é melhor do que realmente pôr a mão na massa em um ambiente prático? Este projeto visa guiar e simplificar a forma com que os novatos fazem a sua primeira contribuição. Se quiser fazer a sua primeira contribuição, siga os passos abaixo.
Se você não se sente confortável com linha de comando, aqui estão alguns tutoriais de ferramentas gráficas.
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/seu-usuario/first-contributions.git
onde "seu-usuario" é 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 ('mergeando') as suas mudanças no Branch principal (master) deste projeto. Você receberá um e-mail de notificação quando as alterações forem mescladas.
Você pode seguramente deletar o seu branch <add-nome-do-branch> após o pull request ser mesclado. Você verá um botão de deletar o branch:
Se o seu Pull Request foi fechado sem ser mergeado, o GitHub irá lhe alertar sobre deleção de commits não mesclados e o botão irá se parecer com isto:
Parabéns! Você completou o básico fork -> clone -> edit -> PR fluxo de trabalho que você encontrará frequentemente como contribuidor!
Celebre sua contribuição e compartilhe com seus amigos e seguidores no app web.
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.
Agora você pode coloborar com outros projetos. Nós compilamos uma lista de projetos com problemas simples que você pode começar. Verifique a lista de projetos no web app.
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |