Skip to content

Latest commit

 

History

History
125 lines (81 loc) · 6.52 KB

README.pt_br.md

File metadata and controls

125 lines (81 loc) · 6.52 KB

Open Source Love Junte-se à nós no Slack License: MIT Open Source Helpers

Primeiras Contribuições

É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros não é algo agradável. Mas open source (código aberto) se trata 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 o que é melhor do que realmente pôr a mão na massa em um ambiente prático? Este projeto visa guiar e simplificar a forma com que os novatos fazem a sua primeira contribuição. Se quiser fazer a sua primeira contribuição, siga os passos abaixo.

Se você não se sente confortável com linha de comando, aqui estão alguns tutoriais de ferramentas gráficas.

fork deste repositório

Se não possui o git em sua máquina, instale-o aqui.

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 o repositório

clonar este repositório

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

Abra seu terminal e execute o seguinte comando do git:

git clone "url que copiou"

onde "url que copiou" (sem as aspas) é a URL deste repositório. Consulte as etapas anteriores para obter a URL.

copiar URL

Por exemplo:

git clone https://github.com/seu-usuario/first-contributions.git

onde "seu-usuário" é 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

Vá para o diretório do repositório no seu computador (caso você não esteja lá):

cd first-contributions

Agora crie 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 ter a sigla "add", mas nesse caso é recomendável, porque a finalidade deste Branch é a de adicionar o seu nome a uma lista.

Efetue as alterações necessárias e faça um Commit

Agora abra o arquivo Contributors.md em seu editor de código, adicione o seu nome a ele e salve o arquivo.

git status

Se você for 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 commit:

git commit -m "Add <seu-nome> to Contributors list"

preenchendo <seu-nome> com o seu nome.

Faça um Push das alterações para o GitHub

Faça um Push utilizando o comando git push:

git push origin <add-seu-nome>

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

Crie um Pull Request

Agora envie um Pull Request.

Envie o Pull Request

Logo estarei mesclando ('mergeando') as suas mudanças no Branch principal (master) deste projeto. Você receberá um e-mail de notificação quando as alterações forem mescladas.

Para onde ir a partir daqui?

Parabéns! Você completou o fluxo de trabalho básico fork -> clone -> edit -> PR que você encontrará frequentemente como contribuidor!

Celebre sua contribuição e compartilhe com seus amigos e seguidores no app web.

Você também pode se juntar à nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. Junte-se à nossa equipe no Slack.

Agora você pode colaborar com outros projetos. Nós compilamos uma lista de projetos com problemas simples que você pode começar. Verifique a lista de projetos no web app.

Tutoriais usando outras ferramentas

GitHub Desktop Visual Studio 2017 GitKraken
GitHub Desktop Visual Studio 2017 GitKraken

Autopromoção

Se você gostou deste projeto, favorite-o com um estrela no GitHub. Se estiver se sentindo especialmente caridoso, siga Roshan no Twitter e GitHub.

http://saasgrids.com