Código limpio
El mejor código es el que se puede leer sin necesidad de comentarios que lo expliquen (aunque más adelante indicaremos lo importante que es documentar nuestro código).
Desarrollar una aplicación implica una comunicación entre el desarrollador y la máquina, donde el desarrollador crea un relato con el que le explica a la máquina qué se espera que haga. Aunque la máquina sea capaz de entender relatos aparentemente confusos, lo ideal es que el relato sea comprensible tanto para la máquina como para cualquier (otro) desarrollador que desee/necesite leerlo.
La filosofía Clean propone un conjunto de ideas que ayuden a que el código sea más fácil de leer, mantener, ampliar y gestionar los errores. Antonio Leiva presenta 12 de esas ideas:
Usa nombres con significado
Haz unidades de código pequeñas
Las unidades de código deben hacer una única cosa
Las funciones deben tener un número limitado de argumentos
Sigue el principio DRY: Don't Repeat Yourself
Evita utilizar comentarios siempre que sea posible
Utiliza un formato único en tu código
Abstrae tus datos: no uses getters y setters indiscriminadamente
¿Conoces la Ley de Demeter?
Lanza excepciones en lugar de devolver códigos de retorno
Establece fronteras
Escribe tests