Após ler um pouco do livro Clean Code de Robert C. Martin, ele diz que não adianta "maquiar" um código ruim com comentários, em outras palavras, tentar explicar uma gambiarra feita ali.
Também é citado sobre explique o que você quer fazer no seu código com seu código e não use comentários para isso.; seguido do exemplo que isso:
if (employee.isEligibleForFullBenefits())
é melhor que isto:
// Verifica se o empregado é elegível aos benefícios
if ((employee.flags & HOURLY_FLAG)
&& (employee.age > 65))
Em adição a esta resposta, onde é escrito como escrever um código limpo e de fácil manutenção, o código abaixo:
public bool ValidacaoCPF(int[] cpf)
{
int DV1 = 0, DV2 = 0, aux = 10;
if (!cpf.All(x => x == cpf.First())) //Verifica se todos os números são iguais
if (cpf[9] == ((DV1 = (cpf.Take(9).Sum(x => (x * aux--)) % 11)) < 2 ? 0 : 11 - DV1)) //Cálculo do primeiro digito verificador
return cpf[10] == (((aux = 11) * 0) + (DV2 = (cpf.Take(10).Sum(x => (x * aux--)) % 11)) < 2 ? 0 : 11 - DV2); //Cálculo do segundo digito verificador
return false;
}
Passou a ser isso:
if (!cpf.All(x => x == cpf.First())) //Verifica se todos os números são iguais
//Cálculo do primeiro digito verificador
if (cpf[9] == (
(DV1 = (
cpf.Take(9).Sum(x => (x * aux--)) % 11
)) < 2 ? 0 : 11 - DV1
))
{
//Cálculo do segundo digito verificador
aux = 11;
return cpf[10] == (
(DV2 = ( cpf.Take(10).Sum(x => (x * aux--)) % 11 )) < 2 ?
0 :
11 - DV2);
}
Por mim, não teve quase nenhuma mudança significativa, apenas está tentando explicar algo que não entenderia se não tivesse aqueles comentários ali. Logo então, se encaixa num código sujo para mim.
Em outras palavras, foi usado comentários para explicar algo que não entenderíamos ora senão pela existência dos mesmos ali.
Por suma, os comentários realmente sujam o código ao invés de limpá-los? Onde devemos usá-los e quando devemos evitá-los?
Informações retiradas da página 86 e 87 do livro citado acima.