¿Qué es el código limpio?
El código limpio es código que es fácil de leer, entender y modificar. No se trata solo de que funcione, sino de que otros desarrolladores (e incluso tu yo futuro) puedan entenderlo sin dificultad.
Según Robert C. Martin, autor del libro 'Clean Code', el código limpio siempre parece que fue escrito por alguien que se preocupa. Expresa el intento del programador de manera clara.
Nombres significativos
Los nombres que eleges para variables, funciones y clases comunican intención. Un nombre significativo hace que sea obvio por qué existe una variable o qué hace una función.
Evita nombres genéricos como 'temp' o 'data'. En cambio, elige nombres que describan claramente el propósito y el contenido de la variable.
Funciones pequeñas y focalizadas
Las funciones deben hacer una sola cosa y hacerla bien. Una función que hace demasiadas cosas es difícil de entender, probar y mantener.
El principio de responsabilidad única (Single Responsibility Principle) sugiere que una clase u objeto debe tener una única razón para cambiar. Lo mismo aplica a las funciones.
Comentarios y documentación
Los comentarios no son malos, pero el código debería ser tan claro que los comentarios sean innecesarios. Si sientes que necesitas un comentario para explicar qué hace tu código, es probable que el código pueda ser escrito de manera más clara.
La documentación es importante, pero debe estar en el código a través de nombres significativos y estructura clara, no como notas adicionales.