No te fíes de los comentarios

A lo largo de nuestras trayectorias profesionales veremos muchos comentarios, y veremos cosas como:

• Comentarios no mantenidos
• Comentarios redundantes
• Etc.

Todo esto finalmente nos lleva a desconfiar de los comentarios ya a simplemente ignorarlos ya que no aportan ningún valor.

Por eso en vez de intentar comentar el código intenta renombrar las variables y los nombres de los métodos para que sean más expresivos y sean auto-explicativos. Por otro lado intenta evitar el el uso de los números mágicos.

Por otro lado, los comentarios pueden ser utilizados pero con una causa justificada (esto debe pasar poco).