~/questoes/codex
Uma mensagem de commit é o registro textual que acompanha cada mudança salva no Git. Ela deve comunicar claramente o quê foi alterado e por quê, criando um histórico compreensível do projeto que ajuda você e outros desenvolvedores a entenderem as decisões tomadas ao longo do tempo.
A mensagem ideal descreve o que foi alterado e o motivo da alteração. Isso permite que qualquer desenvolvedor, consultando o histórico do Git, entenda rapidamente por que uma linha de código foi modificada, facilitando o rastreamento de bugs, revisões de código e manutenção futura.
Descrições claras do que foi alterado e por quê são essenciais para um histórico de commits útil. Quando você volta ao código semanas depois, ou quando outro desenvolvedor precisa entender uma mudança, uma mensagem bem escrita economiza tempo e evita confusão.
Embora o Git registre automaticamente o autor e a data de cada commit, isso não precisa estar na mensagem. O Git já armazena essas informações separadamente, e incluí-las redundantemente polui a mensagem de commit.
A mensagem de commit não deve depender de links externos. Ela deve ser auto-contida e funcionar mesmo se o link ficar quebrado no futuro. Além disso, nem todo projeto usa Vercel ou pull requests.
O número de linhas adicionadas ou removidas é informação técnica que o Git já calcula automaticamente. A mensagem deve focar no significado das mudanças, não em métricas brutas de código.