Roshanjossey
5.6 KiB
Primeiras Contribuições
 |
GitHub Interface de Linha de Comandos (CLI) |
|---|
Esse guia é para nós, os nerdes de terminal, que querem fazer tudo no terminal, e graças a Github-CLI, podemos alcançar isso, lembrando que sua primeira contribuição deve ser divertida, recompensadora, e uma motivação para seguir em frente!
Esse guia é um pouco mais desafiador desde que já não estamos utilizando nenhum interface gráfico, mas é ainda bem divertido e você com certeza consegui acompanhar!
O primeiro requisito é para ter:
- Git instalado (como instalar git git)
- Ter uma conta no GitHub
Agora precisamos instalar a ferramenta github-cli no nosso sistema seguindo o documentação oficial
Depois disso, precisamos fazer login no CLI, só executar esse comando:
gh auth login
Segue as instruções e estamos prontos!
Fork esse repositório
É tão fácil quanto executar este comando:
gh repo fork firstcontributions/first-contributions
Importante: Ele vai incitar para você se gostaria de clonar também, selecione a opção "yes"
Cria o seu branch
Vamos fazer esse próximo passo com o git, so insira esse comando substituindo o nome pelo seu nome, por exemplo:
git switch -c add-john-doe
Faça as mudanças necessários e commit as mudanças
Agora você pode abrir a pasta Contributors.md em um editor de texto e adicione o seu nome na pasta. Coloca o seu nome em qualque lugar entre o começo e o final, aí salva a pasta.
No diretório do projeto execute git status e você verá as mudanças.
Adicione essas mudanças no branch que você acabou de criar usandogit add command:
git add Contributors.md
Agora commit essas mudanças usando o comando git commit:
git commit -m "Add seu-nome à lista de colaboradores substituindo seu-nome pelo seu nome.
Push as mudanças para o github
Push as suas mudanças usando o comando git push:
git push origin -u seu-nome-branch
replacing seu-nome-branch com o nome do branch que você criou anterioramente.
Se você receber algum erro durante o push, clique aqui:
-
Erro de Autenticação
remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead. remote: Por favor veja https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ para mais informações. fatal: Authentication failed for 'https://github.com//first-contributions.git/'
Vá para o Tutorial do GitHub sobre como gerar e configurar uma chave SSH para sua conta.
Enviando suas mudanças para revisão
Executando esse comando no diretório do nosso repositório vai criar um pull request para revisão:
gh pr create --repo firstcontributions/first-contributions
Depois disso envia o seu pull request.
Você pode utilizar o comando gh status para
You can use the command gh status para ver sua solicitação pull mencionada em ação.
Para onde ir a partir daqui?
Parabéns! Você acaba de completar o wokflow de standard fork -> clone -> edit -> pull request que você encontrará frequentemente como colaborador!
Comemore sua contribuição e compartilhe-a com seus amigos e seguidores acessando web app.
Você pode se juntar à nossa equipe do Slack se precisar de ajuda ou tiver alguma dúvida. Junte-se à equipe do Slack.
Agora vamos começar a contribuir para outros projetos. Compilamos uma lista de projetos com problemas fáceis nos quais você pode começar. Confira the list of projects in the web app.