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

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

Faz um Fork deste repositório

Faz um Fork ao clicares no botão "Fork" no topo desta página. Isto vai criar uma cópia deste repositório na tua conta.

Clone o repositório

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

Abre o teu terminal e executa o comando seguinte:

git clone "url que copiou"

onde "url que copiou" (sem as aspas) é a URL deste repositório. Consulta 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 estas 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 cria 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 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 abre o ficheiro Contributors.md no teu editor de código, adiciona o teu nome nele e guarda o ficheiro. Se fores para o diretório do projeto e executar 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"

preenche <Teu-nome> com o 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.

Logo estarei a incorporar 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