o valor de bons nomes de variáveis … um bom indício do que há por vir…

já teve que mexer em um código que você está vendo pela primeira vez? muito provavelmente sim. então você vai entender do que eu vou falar.

a primeira coisa que eu faço quando preciso mexer em um código pela primeira vez é ler o código. o meu objetivo é entender o que ele faz. a segunda é identificar o que precisa ser alterado ou incluído. enfim, a terceira é codificar a alteração.

infelizmente todas estes passos se tornam muito mais complicados e dolorosos porque a pessoa que escreveu aquele código tinha tudo na cabeça e tinha preguiça de escrever. além disso, devia estar doido para ver logo o resultado do trabalho. então ele tenta codificar o mais rápido possível, teclando o menos possível. qual o resultado?

os nomes das variáveis são os piores possíveis e os menores possíveis. embora a pessoa que escreveu tinha tudo na mente, quem mexer neste código depois vai ter muito mais trabalho para: 1. entender o que o código faz, 2. identificar o que precisa ser alterado e 3. codificar a alteração.

recentemente eu comecei a ler um código onde a primeira linha era a que está abaixo. o que você acha que eu podia esperar das próximas linhas!!?? :(

    1: public void MetodoQualquer()
    2:        {
    3:            int i, j, y, k, w;

algumas vezes acompanhei pessoas escreverem código usando estas variáveis “mágicas”. algumas vezes em entrevistas outras vezes fazendo “pair programming”. o que acontece na maioria das vezes é que o próprio desenvolvedor se confunde ao usá-las. imagine então quem for ler este código depois.

nunca devemos subestimar o valor de bons nomes de variáveis.

parte do problema começa nas escolas técnicas ou faculdades. é comum vermos os professores usarem estas variáveis mágicas em pequenos exemplos. recentemente eu estava ajudando um rapaz que faz um curso técnico. ele me mostrou o código de um trabalho dele. o código estava correto, mas cheio destas variáveis mágicas. e o professor dele aceitou e não fez nenhuma observação. e provavelmente será assim pelo resto do curso.

Comments

• Anonymous
  January 11, 2011
  french??right ?