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 clicando no botão "Fork" no topo desta página, uma cópia deste repositório será criada em sua conta.
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.
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 <add-seu-nome>
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.
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.
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.
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.
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 em a lista de projetos no web app.
GitHub Desktop | Visual Studio 2017 | IntelliJ IDEA |