Los 10 mandamientos para escribir buen código

programming

1.- DRY(Don´t Repeat Yourself). No te repitas a ti mismo. Intenta no repetir código. Hazlo abstracto de forma que puedas usar el mismo código en sitios distintos.

2.- Escribe métodos cortos. Tu código será más legible, fácil de probar y de reusar.

3.- Nombra tus clases, métodos y variables con sentido. De esta forma tu código será mucho más comprensible.

4.- Defina claramente la tarea de cada clase. Así conseguirás reducir el número de errores y la reutilización de dicha clase en otras partes de tu aplicación.

5.- Mantén tu código organizado. Organízalo a 2 niveles: físico y lógico.

6.- Crea casos de prueba. Para cada vez que modifiques tu código, puedas de una forma rápida y segura, asegurarte de que lo que has modificado funciona.

7.- Refactoriza pronto y a menudo. El desarrollo del software es un continuo proceso de adaptaciones a los nuevos requisitos, por lo tanto refactoriza y adapta tu código continuamente.

8.- Los comentarios son malignos. Siempre nos han dicho que comentemos el código, que es bueno, especialmente ese código un poco obtuso. En este caso, en vez de comentar, lo que deberíamos hacer es ese código más legible y comprensible.

9.- Piensa en Interfaces más que en implementación. De esta forma nos aseguramos una buena relación entre las clases. Así, nuestras clases estarán expuestas a cambios, sin que afecten a otras clases.

10.- Revisa el código. Lo mejor de éste último, es que lo revise alguien ajeno al código que va a ser revisado.

Visto aquí. Nota: esto NO es una traducción literal del post original. Sólo he seguido el mismo y más o menos descrito desde mi propia experiencia cada uno de los puntos.