#1: Git básico

April 8, 2017

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.

  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 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 OSX).

  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 e grave o arquivo. Dicas importantes:

    • 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.
  11. Confirme suas modificações com o comando git commit -a. A descrição 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.
  12. Envie suas modificações para o seu fork usando comando git push origin desafio --force.

  13. 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

  14. Visite a página do Pull Request e espere o Travis-CI terminar a verificaçã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 pelo Travis-CI.
    4. Crie outro commit com git commit -a e use uma descrição adequada (ex: Conserto de problema X.)
    5. Envie o commit para o seu fork com git push origin desafio --force.
    6. Importante: Não é necessário (ou recomendável) fechar o PR e reabrir.
    7. Repita o processo: Verifique se o Travis-CI finalizou a checagem sem problemas. Em caso de problemas, repita os passos acima.
  15. 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.

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

Dificuldade

Fácil.