A técnica básica e fundamental para se fazer bons comentários é se colocar no lugar de um futuro leitor do código que não fez parte do projeto e não conhece as regras de negócio e os cenários tão profundamente. 

Isso inclui prever e explicar futuras dúvidas que o leitor possa ter. Por exemplo, quando há uma maneira padrão para realizar uma tarefa e por algum motivo específico (desempenho, bugs, etc) optou-se por uma solução diferente. Dessa forma o desenvolvedor não perde tempo tentando adivinhar porque algo foi feito de uma forma e não de outra.

  • Sem rótulos