From 5193a1347e276ea48023267be4822d6dc077a393 Mon Sep 17 00:00:00 2001 From: Adriano Avelino Date: Sat, 5 Mar 2016 14:51:44 -0300 Subject: [PATCH 1/2] =?UTF-8?q?Criando=20o=20manual=20de=20contribui=C3=A7?= =?UTF-8?q?=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Como-Contribuir/README.md | 78 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 Como-Contribuir/README.md diff --git a/Como-Contribuir/README.md b/Como-Contribuir/README.md new file mode 100644 index 000000000..bffb59575 --- /dev/null +++ b/Como-Contribuir/README.md @@ -0,0 +1,78 @@ +# Como contribuir? +Embora pareça ser algo impossível e que somente os ***"fodões"*** podem fazer, você pode perceber que há coisas simples que podem ser feitas como correções de links que apontam para um url inválida, erros de digitação, caminhos de imagens, coorcordância e demais regras gramaticais. + +Sabe quando você encontra algum conteúdo que não está legal? Então! Ao invés de reclamar faça melhor, contribua. Vai que a sua contribuição é aceita? + +## Por onde começar? +1. Acesse a url do projeto: [https://github.com/Webschool-io/be-mean-instagram](https://github.com/Webschool-io/be-mean-instagram) +2. Fork o projeto +3. Clone o projeto `be-mean-instagram` do seu github +``` +git clone https://github.com/seunomedeusuario/be-mean-instagram.git +``` +> Obs: Substitua `seunomedeusuario` pelo seu usuário do GitHub + + Exemplo utilizando o meu github. +``` +git clone https://github.com/adrianoavelino/be-mean-instagram.git +``` + +4. Faça referência ao repositório oficial +``` +git remote add upstream https://github.com/Webschool-io/be-mean-instagram/ +``` +Como já sabemos, o seu fork não é atualizado automaticamente com o repositório oficial, para resolver esse problema criamos um novo repositório com o comando `git remote add upstream https://github.com/Webschool-io/be-mean-instagram/`, que será utilizado para sincronizar, no passso 5, o conteúdo da Webschool-io (upstream) com o seu fork (origin), que está localmente. + +5. Sincronize o seu fork com o repositório oficial +``` +git fetch upstream +git rebase upstream/master +``` +Na primeira linha atualizamos o nosso repositório `upstream`, criado no passo 4, com o repositório oficial, Webschool-io. +

+Na terceira linha atualizamos o nosso branch master do repositório `origin` com as atualizações do `upstream`. + +> Lembrando que todas as alterações realizadas no repositório oficial somente serão sincronizadas com os comandos acima. + +## Fluxo da contribuição +O fluxo da contribuição funciona da seguinte maneira: com o seu repositório sincronizado com o oficial crie uma nova `branch`, realize as alterações, adicione o arquivo e commit, sincronize as alterações do seu branch com o master, envie as alterações para o seu fork no GitHub e envie um `new pull request` para o repositório oficial do projeto. Não entendeu nada do que foi dito aqui? Calma, calma! Mostrarei o passo a passo aqui abaixo: + +### 1º passo - crie uma nova branch +``` +git checkout -b nomedobranch +``` +Exemplo: +``` +git checkout -b corrigindo-link +``` +> Esse passo não é obrigatório, mas é uma boa prática sempre criar um branch para cada alteração + +### 2º passo - realize as alterações, adicione o arquivo e commit +Com as alterações realizadas, siga os seguintes passos: +``` +git add --all +git commit -am ‘corrige o caminho do link’ +``` +### 3º passo - sincronize as alterações do seu branch com o master +``` +git checkout master +git merge upstream/master master +git branch -D nomedobranch +``` +Exemplo: +``` +git checkout master +git merge upstream/master master +git branch -D corrigindo-link +``` + +### 4º passo - envie as alterações para o seu fork +``` +git push origin master + +``` + +### 5º passo - Envie um new pull request +Confira no seu fork do GitHub se as alterações ficaram corretas, então envie um `new pull request` com uma mensagem bem descritiva e aguarde para que seja aceita a sua contribuição. + +### Quando iniciar uma nova contribuição inicie pelo 1º passo. From e072d40788f506edc22bf9d48d2bff8accfc5df4 Mon Sep 17 00:00:00 2001 From: Adriano Avelino Date: Sat, 5 Mar 2016 14:59:14 -0300 Subject: [PATCH 2/2] =?UTF-8?q?Corrigindo=20comandos=20do=20manual=20de=20?= =?UTF-8?q?contribui=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Como-Contribuir/README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Como-Contribuir/README.md b/Como-Contribuir/README.md index bffb59575..f1b46923f 100644 --- a/Como-Contribuir/README.md +++ b/Como-Contribuir/README.md @@ -62,12 +62,14 @@ git branch -D nomedobranch Exemplo: ``` git checkout master -git merge upstream/master master +git merge corrigindo-link master git branch -D corrigindo-link ``` ### 4º passo - envie as alterações para o seu fork ``` +git fetch upstream +git rebase upstream/master git push origin master ```