README.pt_br.md

Primeiras Contribuições

É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros 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 deste repositório

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.

Clone o repositório

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 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-usuário" é o seu usuário do GitHub. Aqui você está copiando o conteúdo do repositório first-contributions para o seu computador.

Crie um Branch

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.

Efetue as alterações necessárias e faça um Commit

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 das alterações para o GitHub

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.

Envie suas alterações para serem revisadas

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.

Para onde ir a partir daqui?

Parabéns! Você completou o fluxo de trabalho básico fork -> clone -> edit -> PR que você encontrará frequentemente como contribuidor!

Celebre sua contribuição e compartilhe com seus amigos e seguidores no app web.

Você também pode se juntar à nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. Junte-se à nossa equipe no Slack.

Agora você pode colaborar 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.

Material adicional

Tutoriais usando outras ferramentas

GitHub Desktop	Visual Studio 2017	GitKraken	IntelliJ IDEA