Los comentarios son usualmente creados con la mejor intención, cuando el programador realiza esto es debido a que su código no es obvio o intuitivo. En tales casos, los comentarios son como un desodorante enmascarando el olor de un pescado.
La mejor forma de comentar tu código es elegir buenos nombres para tus métodos o clases.
Si sientes que un fragmento de código no puede ser entendido sin comentarios, entonces intenta cambiar la estructura del código de manera que los comentarios no sean necesarios.
Fuente: https://refactoring.guru
0 Comments