Git básico

Objetivo

Neste desafio, o seu objetivo é adicionar o seu nome à lista de participantes do grupo no GitHub.

Instruções

1. Leia o tutorial sobre Git. Caso você use Windows, leia as instruções de instalação neste artigo. A documentação oficial do Git em português está disponível no site do Git.

2. Crie sua conta no GitHub (ou use uma conta previamente criada, se já existir).

3. Visite o projeto do site do grupo e faça o fork do projeto para a sua conta no GitHub clicando no botão Fork no canto superior direito da tela.

4. Instale o git na sua máquina. Se o seu Sistema Operacional (SO) já possui o git em um pacote pronto, é extremamente recomendável instalá-lo através dos comandos do seu SO.

5. Acesse a linha de comando (Windows) ou abra um terminal (Linux ou macOS).

6. Crie um diretório onde você deseja instalar o projeto do site.

7. Crie um clone do seu fork no github, na sua máquina. A opção --recursive é importante neste caso:

   git clone --recursive https://github.com/<seu usuário do GitHub>/op-website-hugo.git
   

8. Crie um remote apontando pro repositório original:

   git remote add upstream https://github.com/osprogramadores/op-website-hugo.git
   

9. Crie um branch de trabalho com o commando:

   git checkout -b desafio
   

10. Adicione os seus dados ao arquivo PARTICIPANTES.md, usando o seu editor favorito, e grave o arquivo. Dicas importantes:

• Sugestões de Editores: vim, Visual Studio Code, NetBeans, Sublime Text and many others.
• O arquivo é ordenado alfabeticamente por nome!
• Mantenha a estrutura já existente no arquivo (adicione as barras verticais como nos casos já existentes).
• Use apenas espaços (não tabs).
• Cuidado com espaços extras no final da linha.
• As suas alterações serão automaticamente rejeitadas se as condições acima não forem observadas.

1. Encerre o seu editor e retorne para a linha de comando do Windows, macOS ou Linux:

2. Digite o comando git status e pressione enter ou return no teclado.

3. O git irá exibir uma mensagem semelhante a: modified: PARTICIPANTES.md

4. Use o comando git add nome-arquivo onde nome-arquivo deve ser substituído pelo nome do arquivo que foi modificado (incluindo o path/caminho para o arquivo).

5. Confirme suas modificações com o comando git commit -m "Mensagem aqui". A mensagem deverá se limitar a 60 caracteres. Use sentenças completas (começando com uma letra maiúscula e terminando com um ponto). O texto deve ser sucinto e descritivo. Exemplos de boas e más descrições:

   • Inclusao: Ruim, pois não possui detalhes suficientes.
   • include de participante: Ruim. Não começa com maiúscula, sem pontuação, informação insuficiente.
   • particpantes.md: Ruim. Não descritivo. Nome do arquivo errado.
   • Inclusão de participante: @seuusername.: Bom exemplo.

6. Envie suas modificações para o seu fork usando comando git push origin desafio.

7. Acesse o fork do repositório op-website-hugo na sua conta do GitHub e solicite um Pull Request para o repositório do OsProgramadores

8. Visite a página do Pull Request e aguarde a validação automática da sua solução. Em caso de erros clique no link Details e efetue o conserto. Nesses casos:

   1. Faça a atualização do seu repositório local com git pull -r upstream master. Não há risco de perder as suas alterações com esse comando.
   2. Se o git indicar conflito, edite novamente o arquivo PARTICIPANTES.md e remova o conflito. Observe que nesses casos o git coloca marcadores de conflito no arquivo, que também devem ser removidos.
   3. Edite o arquivo e conserte o problema indicado pela validação automática.
   4. Crie outro commit com git commit -m "Mensagem aqui" e use uma descrição adequada (ex: Conserto de problema X.)
   5. Envie o commit para o seu fork com git push origin desafio.
   6. Importante: Não é necessário (ou recomendável) fechar o PR e reabrir.
   7. Repita o processo: Verifique se a validação automática finalizou a checagem sem problemas. Em caso de problemas, repita os passos acima.

9. Aguarde a resposta dos admins. É importante prestar atenção aos comentários feitos pelos admins e corrigir eventuais problemas. Observe que Pull Requests (PRs) inativos por duas semanas serão automaticamente fechados.

10. Quando o seu PR tiver sido aceito (status = Merged no github), remova o branch criado com git checkout master seguido de git branch -d desafio.

Nível de dificuldade: Fácil.