Code comments best practices

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

Leave a Reply

Avatar placeholder

Your email address will not be published. Required fields are marked *