Skip to content

Latest commit

 

History

History
105 lines (71 loc) · 6.78 KB

README.pt-pt.md

File metadata and controls

105 lines (71 loc) · 6.78 KB

Open Source Love License: MIT Open Source Helpers

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

fork deste repositorio

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

clonar este 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.

copiar URL

Por exemplo:

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

onde "este-eh-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.

Cria um Pull Request

Agora envia um Pull Request.

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.

Tutoriais com outras ferramentas

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