19 março 2011

Mensagens de commit

Pra muita gente, pensar em mensagens de commit é uma coisa chata. Quando estamos descobrindo uma solução no código, o ato de parar um momento pra "commitar" e ainda ter que pensar numa forma rápida e clara pra descrever o último passo pode parecer quebrar a linha de raciocínio. O mais comum é que a ansiedade em voltar pro código faça o programador deixar essas mensagens em branco ou escrever qualquer baboseira.

Não faça isso!

Quem sofre é a pessoa que precisa depois achar o ponto certo pra reverter uma mudança, pra 'mergear' dois branches, ou pra recuperar uma peça de código que se jogou fora, mas então se percebeu que era útil.

Além disso, faço uma relação direta entre essas paradinhas e a organização pessoal das tarefas. Uma paradinha pra consolidar e deixar clara a finalização de um baby-step na evolução do código é muito muito muito útil. Sobre essa relação entre as mensagens de commit e o processo de organização (GTD, TDD, Pomodoro) prefiro recomendar que assistam à apresentação da cozinha ;-)

Minha dica:

Antes de mais nada, acostume-se com a necessidade de dar paradinhas frequentes e refletir sobre o que foi feito. Se você ainda não faz isso é porque ainda tem muito o que melhorar em suas habilidades técnicas como programador.



A hora de "commitar" é a mesma hora de atualizar seus micro-planos (em cartões, folhas de papel, aquivos txt, mind-maps, whatever), progressos, estimativas, etc.

Além disso, quando for pensar na mensagem de commit, uma boa recomendação é adotar o estado de espírito de quem está tuitando algo, mandando um email "dipé", comunicando o status da tarefa, ou batendo um chat com uma pessoa que está não em outro lugar, mas em outro tempo. Imagine que vc está mandando um SMS para o cara que está revisando o histórico do controle de versão, procurando o ponto exato onde se fez uma determinada mudança.


Como vários outros aspectos da programação, isso é apenas uma questão de disciplina e auto-aperfeiçoamento, que obviamente depende da boa vontade e da intenção em fazer um trabalho bem feito.

Da próxima vez que for comitar código, pense nisso.

o/