Mensagem de commit como 'ajuste' ou 'correção' parece suficiente no momento, mas daqui a alguns meses, olhando o histórico do projeto, essa mensagem não ajuda em nada a entender o que realmente mudou e por quê.
Por que isso importa mesmo em projeto pessoal
Mesmo sozinho, você vai esquecer o contexto de uma mudança feita há meses. Uma boa mensagem de commit funciona como um bilhete pro seu eu do futuro, explicando o que mudou e o motivo.
Características de uma boa mensagem de commit
- Diz o que mudou de forma específica, não genérica
- Explica o porquê da mudança, quando não é óbvio
- É curta o suficiente pra ler rápido, mas completa o suficiente pra entender
- Usa um padrão consistente ao longo do projeto
Exemplo de mensagem fraca vs boa
Uma mensagem fraca seria apenas 'fix'. Uma mensagem melhor seria algo como 'corrige cálculo de total que ignorava desconto acima de 10%' — específica sobre o que mudou e por quê.
Erros comuns ao escrever commit
- Fazer um commit gigante misturando várias mudanças diferentes
- Usar sempre a mesma mensagem genérica
- Não explicar o motivo quando a mudança não é óbvia por si só