Espero (sinceramente) que você use algum sistema de controle de versões. A idéia aqui é (como o título sugere) expressar a importância das mensagens de commit em um projeto.

Nossa função

Expressar nosso objetivo como profissionais é sempre algo delicado de se fazer, ainda mais algo genérico. Provavelmente essa minha definição mude com o tempo, mas atualmente ela seria algo assim:

"Arquitetar um conjunto de necessidades com a finalidade de evoluir da maneira
mais simples e óbvia possível."

A expressão tem duas partes, a primeira convém a evolução lógica e inexorável de um software que (assim como praticamente tudo) surge sempre de uma necessidade. Não acho que exista nada de muito delicado nem questionável aí.

A segunda parte fala de simplicidade. O ponto delicado aqui é entender o que é simplicidade.

Simplicidade

É bem natural pensar que qualquer coisa ”grande” seja complexa, assim como é natural ver algo simples e não esperar resultados magníficos.

Toda uma genialidade é necessária para abstrair algo complexo de maneira simples. Exemplos disso são: a teoria da gravidade e consequentemente da relatividade e a web.

A simplicidade é importante porque ela é extremamente acessível. Não é necessário muito estudo nem habilidade pra entender algo simples, seja qual for esse entendimento. Entender ”algo” não é tão importante e essencial quanto consumir os benefícios desse mesmo ”algo”.

Simplicidade em software é importante por diversos motivos, o que nos interessa aqui é o ponto específico de que o software precisa ser mantido. Tornar essa manutenção uma tarefa simples é uma obrigação e ferramentas pra isso existem várias: comentários simples, PHPDoc, padrões de codificação, Testes Unitários, Testes de Comportamento e (porque não) mensagens de commit.

Mensagens de commit

Todo código que produzimos é fruto de algum pensamento lógico, por mais ilógico que ele pareça. Tentamos deixar esse fruto o mais simples possível de se entender, essa simplicidade é grande responsável pela evolução do software como produto final.

Porém o código tem um limite. Comentários no meio dele mais atrapalham do que ajudam quando ele é simples o suficiente, eles só são necessários quando o código é extremamente ineficiente em expressar à um humano seus objetivos.

Lembre-se que (se) você escreve códigos numa linguagem de alta abstração para humanos entenderem e não para máquinas. O problema de comunicação com a máquina já esta resolvido em camadas abstratas mais baixas.

Porém comentários em códigos tem problemas, o mais crítico é a falta de ordem cronológica neles. Algo que uma mensagem de commit faz naturalmente. E como saber à que pedaço de código aquela mensagem de commit pertence? Procure por blame no seu gerenciador de versão preferido.

A mensagem de commit deve expressar o objetivo que aquele conjunto de mudanças têm de maneira clara e objetiva, ela é uma ferramenta fenomenal de discussão muito pouco utilizada.

Uma mensagem de commit digna de entrar no controle de versões deve responder à algumas perguntas:

  • Qual problema ele resolve
  • Como o problema é resolvido
  • Se necessário, o porquê determinada solução foi escolhida

Ela é a melhor forma de comunicação para um desenvolvedor dentro de um projeto. Esqueça os bug trackers, o GitHub, e-mail, ferramentas de review de código e demais soluções. As mensagens de commit não substituem elas, mas são a melhor ponte de comunicação entre os desenvolvedores e códigos já que além de tudo, estão ligados à eles. Virtualmente (ou fisicamente se você encarar que o sistema de arquivos é algo físico) e cronologicamente.

Quer saber o que se passava na cabeça de um desenvolvedor ao criar, alterar ou remover linhas de código? O que você deve procurar como resultado no código e como ele vai se comportar? As mensagens de commit são ótimas alternativas. indubitavelmente superiores aos comentários dentro do código.

Exemplo

Quer um exemplo bacana? O Respect tem um projeto chamado Foundation cuja promessa é ser justamente a fundação que um desenvolvedor precisa para o desenvolvimento. O Nickl- é um desenvolvedor que contribui bastante com o projeto e existe uma alteração relativamente grande que ele fez. É importante entender o impacto de uma grande alteração o que torna inevitável ler códigos de implementação e testes, tarefa que nem sempre é algo que alguém se candidataria a fazer.

Te convido a fazer isso no conjunto de alterações que ele fez. Mesmo sem nunca ter visto o projeto. Procure pelo pedaço de código que cada commit altera e tente entender o que foi feito e como o componente funciona. Para isso use a interface web do Github ou clone o repositório e veja no próprio Git se estiver inspirado.

Dê a devida importância às mensagens de commit. Todo desenvolvedor vai agradecer eternamente por isso.

Conclusão

Espero ter conseguido mostrar a importância que uma simples mensagem de commit tem. O quão simples e vital é ter isso em qualquer projeto.

Se tudo for como eu espero, todas suas próximas mensagens de commit serão algo que valha ser lido ao invés de ser algum pedaço de texto que alguma ferramenta estúpida requer repetidamente a fim de fazer algo.