README.pt-pt.md

Primeiras Contribuições

É 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 projecto visa simplificar a forma com que os novatos fazem a sua primeira contribuição. Lembre-se: quanto mais relaxado(a) estiveres, melhor aprenderás. Se quiseres fazer a tua primeira contribuição, siga os passos abaixo. Nós prometemos, será divertido.

Se ainda não tens o git na tua máquina, instala-o aqui.

Faz Fork deste repositório

Faz Fork clicando no botão "Fork" no topo desta página. Esta operação criará uma cópia deste repositório na tua conta.

Clona o repositório

Agora clona este repositório para a tua máquina local. Clique no botão "Clone or download" e, em seguida, clica no ícone "Copy to clipboard" para copiar o URL.

Abre o teu terminal e executa o comando seguinte:

git clone "url que copiou"

onde "url que copiou" (sem as aspas) é o URL deste repositório. Consulte as etapas anteriores para obter o URL.

Por exemplo:

git clone https://github.com/este-é-voce/first-contributions.git

onde "este-é-voce" é o teu nome de usuário do GitHub. Aqui estás a copiar o conteúdo do repositório first-contributions para o teu computador.

Cria um Branch

Vá para o diretório do repositório no teu computador (caso ainda não estejas lá):

cd first-contributions

Agora crie um novo Branch usando o comando git checkout:

git checkout -b <add-teu-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.

Efetua as alterações necessárias e faz um Commit

Agora abra o ficheiro Contributors.md no teu editor de código, adiciona o teu nome e guarda o ficheiro. Se fores para o diretório do projeto e executares 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"

substitui <Teu-nome> pelo teu nome ou nickname.

Faz um Push das alterações para o GitHub

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.

Envia as tuas alterações para serem revistas

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.

Quando puder incorporarei as tuas mudanças no Branch principal (master) deste projeto. Vais receber um e-mail de notificação quando as alterações forem incorporadas.

Para onde ir a partir daqui?

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.

Material adicional

Tutoriais com outras ferramentas

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA