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
   

   Nota: --recursive é um parâmetro usado para clonar submódulos de um repositório, sendo um pseudônimo do parâmetro --recurse-submodules. A opção é ignorada pelo git se no projeto em questão não houver submódulos. Ou seja, se não houver por exemplo diretórios de projetos de terceiros no repositório.

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.