README.pt_br.md

Primeiras Contribuições

Este projeto visa facilitar o caminho e guiar os iniciantes em suas primeiras contribuições. Se você deseja fazer a sua primeira contribuição, siga os passos abaixo.

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

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, uma cópia deste repositório será criada em sua conta.

Clone o repositório

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

Abra um 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 (seu fork deste projeto). Consulte as etapas anteriores para obter a 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ê estará copiando o conteúdo do repositório first-contributions para o seu computador.

Crie um Branch

Acesse o diretório do repositório no seu computador (caso você não esteja nele):

cd first-contributions

Agora crie um Branch usando o comando git switch:

git switch -c <nome-da-sua-nova-branch>

Por exemplo:

git switch -c add-andre-oliveira

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 à 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 e adicione o seu nome a ele. Não o adicione no início ou no final do arquivo. Coloque-o em qualquer lugar no meio. Agora, salve o arquivo.

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, confirme essas alterações usando o comando git commit git commit:

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

substituindo <seu-nome> pelo seu nome.

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

Envie suas alterações usando o comando git push:

git push origin <nome-da-sua-branch>

substituindo <nome-da-sua-branch> 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.

Agora envie um Pull Request.

Logo estará mesclando ('mergeando') as suas mudanças no Branch principal (main) 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.

Se você quiser mais prática, verifique code contributions.

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

Material adicional

Tutoriais usando outras ferramentas

GitHub Desktop	Visual Studio 2017	IntelliJ IDEA