Capítulo 06: As Crônicas do Tempo (Mensagens de Commit) 📝📜
Neste capítulo, vamos aprender a escrever mensagens de commit claras e úteis, para que você e sua equipe saibam exatamente o que foi feito no passado, usando o tema Diário de Bordo!
📖 Boas Práticas para Mensagens
Quando você faz um commit, o Git exige uma mensagem (usando -m). Se você escrever mensagens como “teste”, “ajuste” ou “arrumei o bug”, no futuro você não saberá o que aquele ponto de salvamento faz!
Uma boa mensagem de commit deve ser:
- Curta e direta: Menos de 50 caracteres no título.
- No imperativo: “Adiciona arquivo” em vez de “Adicionei arquivo”.
- Clara: Diga O QUE você fez (ex: “Corrige bug no login”).
📖 Exemplo Guiado: Boas vs Ruins
Veja a diferença:
- ❌ Mensagem Ruim:
git commit -m "fiz umas coisas" - ❌ Mensagem Ruim:
git commit -m "v1" - ✅ Mensagem Boa:
git commit -m "Adiciona cabeçalho ao site" - ✅ Mensagem Boa:
git commit -m "Corrige cor do botão de ajuda"
📊 Ilustração Visual: O Histórico Claro
graph TD A[Commit 1: Cria projeto] --> B[Commit 2: Adiciona login] B --> C[Commit 3: Corrige bug no login]
🛠️ Prática Obrigatória 1: Mensagem Perfeita
Imagine que você acabou de criar o arquivo personagem.md com o nome e a classe do seu herói. Qual seria a mensagem ideal para esse commit? Escreva o comando completo no seu arquivo de anotações!
🔑 Gabarito de Código
Prática 1:
O comando ideal seria algo como:
git commit -m "Adiciona ficha de personagem"(Ou algo similar que descreva bem a ação!).
📤 Instruções de Entrega (GitHub Desktop + Microsoft Teams)
- Faça o Commit: No GitHub Desktop, digite a mensagem (ex:
Finaliza Capítulo X) e clique em Commit to main. - Envie para a Nuvem (Push): Clique em Push origin.
- ⚠️ IMPORTANTE: Seu repositório DEVE SER PÚBLICO.
- No Microsoft Teams:
- Copie o link do seu repositório.
- Cole na tarefa correspondente no Teams.
- Clique em Entregar.