Skip to content

Latest commit

 

History

History
105 lines (71 loc) · 6.77 KB

README.pt-pt.md

File metadata and controls

105 lines (71 loc) · 6.77 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 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

fork deste repositorio

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

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

copiar 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.

Cria um Pull Request

Agora envia um Pull Request.

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.

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