Código Limpo: Nomes Significativos

Às vezes fico com um assunto na cabeça por semanas, até achar uma situação ou um exemplo que esclareça a situação. Explico: estava querendo já a algum tempo escrever sobre boas práticas de programação, e pensei em iniciar por "Nomes Significativos", para seguir a nomenclatura utilizada pelo ótimo livro Código Limpo, de Robert C. Martin. Entretanto, ficava sempre amarrado em exemplos que pareciam ser bons, mas que ainda eu não tinha visto a utilidade prática. 

Antes de continuar preciso explicar que tenho um hábito de anotar num bloco de papel todas as ideias que surgem, pois elas desaparecem com a mesma velocidade que aparecem. Para isso tenho um bloco e caneta na mesa de cabeceira (além de um no banheiro), pois esses são os lugares onde tenho mais ideias... Vai entender...

Semana passada, estava com um problema bem complicado e tive uma ideia: "vou criar uma variável para indicar que quando um arquivo tiver um certo tamanho deve gravar algumas informações no log. Pois eu não queria encher o log de informações inúteis, visto que só precisava verificar a situação quando os arquivos eram maiores que, digamos, 10 MB". Eu ia anotar mais ou menos isso que escrevi, apenas um pouco mais resumido. Mas então, tive a ideia de testar se essa técnica (de utilizar nomes que revelem seu propósito) funciona. Então anotei simplesmente: HabilitarLogParaArquivosMaioresQue10MB

É claro que o exemplo é simples, mas também é claro que funcionou. Uma variável chamada de HabilitarLogParaArquivosMaioresQue10MB não deixa dúvidas sobre o que ela faz e em que contexto deve ser utilizada.

Hoje em dia, programo principalmente em Go, que tem a convenção (Go Way) de utilizar variáveis com nomes curtos para variáveis locais e, importante, com o espoco limitado. Por exemplo, um pequeno for dentro de uma função. Ali podemos utiliza "i" ao invés de "IndiceDoSliceDeClientesAptosAComprar". Mas mesmo utilizando Go, é importante notar que em alguns casos, sim, é preciso utilizar nomes significativos.