Nome de Variável — Se Precisa de Comentário, o Nome Falhou
· 1 min de leitura
Comentário que serve apenas para traduzir o que o código está fazendo geralmente é sintoma de nome ruim.
Escrever "const data = ..." e colocar uma linha em cima explicando que aquilo é a lista de clientes ativos só gera trabalho duplo de leitura. Quando o código muda, o comentário fica desatualizado e vira mentira.
Trocar por um nome claro e autoexplicativo elimina a necessidade de explicação e deixa a intenção do código óbvia para quem mexe nele seis meses depois.