forked from firstcontributions/first-contributions
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
94be3c3
commit 426abdd
Showing
1 changed file
with
137 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,137 @@ | ||
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) | ||
[<img align="right" src="https://firstcontributions.herokuapp.com/badge.svg">](https://firstcontributions.herokuapp.com) | ||
|
||
# Primeiras Contribuiçoes | ||
|
||
É difícil. Sempre é difícil fazer algo a primeira vez. Especialmente quando se está colaborando, errar não é algo agradável. Mas *open source* (o código aberto) se trata de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos contribuidores *open source* aprendem e contribuem pela primeira vez. | ||
|
||
Ler artigos e ver turoriais pode ajudar, mas nada melhor do que fazer as coisas sem estragar nada. Este projeto visa simplificar a forma com que os novatos fazem a sua primeira contribuição. Lembre-se: quanto mais relaxado você estiver, melhor aprenderá. Se quiser fazer a sua primeira contribuição, siga os passos abaixo. Nós prometemos, será divertido. | ||
|
||
<img align="right" width="300" src="../assets/fork.png" alt="fork de éste repositorio" /> | ||
|
||
Se não possui o git em sua máquina, [clique aqui]( https://help.github.com/articles/set-up-git/ ) | ||
|
||
## 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 um repositório | ||
|
||
<img align="right" width="300" src="../assets/clone.png" alt="clonar este repositório" /> | ||
|
||
Agora clone este repositório para a sua máquina. Clique no botão "Clone" e, em seguida, clique no icone "Copy to clipboard". | ||
|
||
Abra o seu terminal e execute o seguinte comando do git: | ||
``` | ||
git clone "url que copiou" | ||
``` | ||
Onde "url que copiou" (sem as aspas) é a URL para este repositório. Consulte as etapas anteriores para obter a URL. | ||
|
||
<img align="right" width="300" src="../assets/copy-to-clipboard.png" alt="copiar URL" /> | ||
|
||
Por exemplo: | ||
``` | ||
git clone https://github.com/este-e-voce/first-contributions.git | ||
``` | ||
Onde "este-e-voce" é 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 | ||
|
||
Altere para o repositório no seu computador(caso você não esteja lá). | ||
``` | ||
cd first-contributions | ||
``` | ||
|
||
Agora crie um branch usando `git checkout command` | ||
``` | ||
git checkout -b <adicione-seu-nome> | ||
``` | ||
|
||
Por exemplo: | ||
``` | ||
git checkout -b add-alonzo-church | ||
``` | ||
Obs.: O nome do Branch não necessita ter a palavra "adicionar", mas é algo comum, porque a finalidade deste Branch é a de adicionar o seu nome a uma lista. | ||
|
||
## Faça as alterações necessárias e realize o 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ê ir 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 `git commit`: | ||
``` | ||
git commit -m "Add <seu-nome> to Contributors list" | ||
``` | ||
preencha `<seu-nome>` com o seu nome. | ||
|
||
## Faça um Push das alterações para o GitHub | ||
|
||
Faça o Push utilizando o comando `git push`: | ||
``` | ||
git push origin <add-kalil-silva> | ||
``` | ||
Substitua `<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. | ||
|
||
<img style="float: right;" src="../assets/compare-and-pull.png" alt="Crie um Pull e Request" /> | ||
|
||
Agora envie o Pull Request. | ||
|
||
<img style="float: right;" src="../assets/submit-pull.png" alt="sube la pull request" /> | ||
|
||
Logo estarei mesclando as suas mudanças na ramificação principal deste projeto. Você verá um e-mail de notificação quando as alterações forem mescladas. | ||
|
||
O Master Branch do seu Fork não terá as mudanças. Para manter o seu Fork sincronizado com o meu, siga os passos abaixo. | ||
|
||
## Mantendo o seu Fork sincronizado com este repositório | ||
|
||
Primeiro, troque para o Master Branch. | ||
``` | ||
git checkout master | ||
``` | ||
|
||
Em seguida, adicione a URL do meu repositório como `upstream remote url`: | ||
``` | ||
git remote add upstream https://github.com/Roshanjossey/first-contributions | ||
``` | ||
Esta é uma forma de dizer ao Git que existe uma outra versão deste projeto na URL especificada e estamos chamando-a de Upstream. Depois que as alterações forem mescladas, busque a nova versão do meu repositório. | ||
``` | ||
git fetch upstream | ||
``` | ||
|
||
Aqui estamos buscando todas as mudanças no meu Fork (Upstream Remote). Agora, você precisa mesclar a nova revisão do meu repositório no seu Master Branch. | ||
``` | ||
git rebase upstream/master | ||
``` | ||
Aqui você está aplicando todas as mudanças que você busco para o seu Master Branch. Se você fizer Push em seu Master Branch agora, seu Fork também terá as alterações. | ||
``` | ||
git push origin master | ||
``` | ||
Note que aqui você está fazendo Push para a URL remota chamada origin. | ||
|
||
## Tutoriais com outras ferramentas | ||
|
||
|
||
|<a href="github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a>|<a href="github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://www.microsoft.com/net/images/vslogo.png" width="100"></a>|<a href="gitkraken-tutorial.md"><img alt="GitKraken" src="/../assets/gk-icon.png" width="100"></a>| | ||
|---|---|---| | ||
|[GitHub Desktop](github-desktop-tutorial.md)|[Visual Studio 2017](github-windows-vs2017-tutorial.md)|[GitKraken](gitkraken-tutorial.md)| | ||
|
||
## Para onde ir a partir daqui? | ||
|
||
Você tambem pode se juntar a nossa equipe Slack no caso de você precisar de alguma ajuda ou ter alguma dúvida. [Junte-se a nossa equipe Slack](https://firstcontributions.herokuapp.com) | ||
|
||
Aqui estão alguns repositórios a nível de inciantes que você poderia resolver. Vá em frente para aprender mais. | ||
|
||
|[![exercism](https://avatars2.githubusercontent.com/u/5624255?v=3&s=100)](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[![fun-retro](https://avatars3.githubusercontent.com/u/15913975?v=3&s=100)](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[<img width="100" src="https://cdn.worldvectorlogo.com/logos/react.svg">](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[![habitat](https://avatars1.githubusercontent.com/u/18171698?v=3&s=100)](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![scikit-learn](https://avatars0.githubusercontent.com/u/365630?v=3&s=100)](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[<img width="100" src="https://camo.githubusercontent.com/0f302c808c8457f6460913e33aed3478124612c2/687474703a2f2f6c65696e696e67656e2e6f72672f696d672f6c65696e696e67656e2e6a7067">](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[<img width="100" src="https://images.plot.ly/plotly-documentation/thumbnail/numpy-logo.jpg">](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[![elasticsearch](https://avatars2.githubusercontent.com/u/6764390?v=3&s=100)](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| | ||
|---|---|---|---|---|---|---|---| | ||
|[exercism](https://github.com/exercism/exercism.io/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+patch%22)|[Fun Retros](https://github.com/funretro/distributed/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly)|[react](https://github.com/facebook/react/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+bug%22)|[habitat](https://github.com/habitat-sh/habitat/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[scikit-learn](https://github.com/scikit-learn/scikit-learn/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[Leiningen](https://github.com/technomancy/leiningen/issues?q=is%3Aopen+is%3Aissue+label%3ANewbie)|[numpy](https://github.com/numpy/numpy/issues?q=is%3Aopen+is%3Aissue+label%3A%22Easy+Fix%22)|[elasticsearch](https://github.com/elastic/elasticsearch/issues?q=is%3Aopen+is%3Aissue+label%3A%22low+hanging+fruit%22)| | ||
|[![homebrew](https://avatars2.githubusercontent.com/u/1503512?v=3&s=100)](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[![rust](https://avatars1.githubusercontent.com/u/5430905?v=3&s=100)](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[![vuejs](https://avatars1.githubusercontent.com/u/6128107?v=3&s=100)](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[![Suave](https://avatars2.githubusercontent.com/u/5822862?v=3&s=100)](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[![OpenRA](https://avatars3.githubusercontent.com/u/409046?v=3&s=100)](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[![PowerShell](https://avatars0.githubusercontent.com/u/11524380?v=3&s=100)](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[![coala](https://avatars2.githubusercontent.com/u/10620750?v=3&s=100)](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[![moment](https://avatars2.githubusercontent.com/u/4129662?v=3&s=100)](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| | ||
|[homebrew](https://github.com/Homebrew/brew/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)|[Rust](https://github.com/rust-lang/rust/issues?q=is%3Aopen+is%3Aissue+label%3AE-easy)|[vuejs](https://github.com/vuejs/vue/issues?q=is%3Aopen+is%3Aissue+label%3A%22contribution+welcome%22)|[Suave](https://github.com/SuaveIO/suave/issues?q=is%3Aopen+is%3Aissue+label%3Ahardness-easy)|[OpenRA](https://github.com/OpenRA/OpenRA/issues?q=is%3Aopen+is%3Aissue+label%3AEasy)|[PowerShell](https://github.com/powershell/powershell/issues?q=is%3Aopen+is%3Aissue+label%3AUp-for-Grabs)|[coala](https://github.com/coala/coala/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty%2Flow+label%3Adifficulty%2Fnewcomer)|[moment](https://github.com/moment/moment/issues?q=is%3Aopen+is%3Aissue+label%3AUp-For-Grabs)| | ||
|[![ava](https://avatars0.githubusercontent.com/u/8527916?v=3&s=100)](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[![freeCodeCamp](https://avatars0.githubusercontent.com/u/9892522?v=3&s=100)](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![webpack](https://avatars3.githubusercontent.com/u/2105791?v=3&s=100)](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[![hoodie](https://avatars1.githubusercontent.com/u/1888826?v=3&s=100)](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[![pouchdb](https://avatars3.githubusercontent.com/u/3406112?v=3&s=100)](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[![neovim](https://avatars0.githubusercontent.com/u/6471485?v=3&s=100)](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[![babel](https://avatars2.githubusercontent.com/u/9637642?v=3&s=100)](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[<img width="100" src="https://github.com/adobe/brackets/blob/gh-pages/images/brackets_128.png?raw=true">](https://github.com/adobe/brackets/labels/Starter%20bug)| | ||
|[ava](https://github.com/avajs/ava/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+for+beginner%22)|[freeCodeCamp](https://github.com/freeCodeCamp/freeCodeCamp/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[webpack](https://github.com/webpack/webpack/issues?q=is%3Aopen+is%3Aissue+label%3A%22D1%3A+Easy+%28Contrib.+Difficulty%29%22)|[hoodie](https://github.com/hoodiehq/hoodie/issues?q=is%3Aopen+is%3Aissue+label%3Afirst-timers-only)|[pouchdb](https://github.com/pouchdb/pouchdb/issues?q=is%3Aopen+is%3Aissue+label%3A%22first+timers+only%22)|[neovim](https://github.com/neovim/neovim/issues?q=is%3Aopen+is%3Aissue+label%3Aentry-level)|[babel](https://github.com/babel/babel/issues?q=is%3Aopen+is%3Aissue+label%3Abeginner-friendly) |[brackets](https://github.com/adobe/brackets/labels/Starter%20bug)| | ||
| [![Node.js](https://avatars1.githubusercontent.com/u/9950313?v=3&s=100)](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)|[<img width="100" src="https://github.com/Semantic-Org/Semantic-UI-React/raw/master/docs/app/logo.png">](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22)| | ||
| [Node.js](https://github.com/nodejs/node/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) |[Semantic-UI-React](https://github.com/Semantic-Org/Semantic-UI-React/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+contribution%22) | |