Clean Code y buenas prácticas

Hacer que el código sea limpio y hermoso es una excelente manera de mantenerse al día con la fecha límite. Robert Martin llegó al punto con una declaración de gran capacidad:
Inspirado en el libro Clean Code de Robert C. Martin , Ryan McDermott reunió un repositorio con algunas de las mejores prácticas de ingeniería de software que se aplican a jаvascript en particular. El repositorio tiene toneladas de excelentes pautas para programadores principiantes y buenos recordatorios para mantenedores experimentados.

Soy un fanático particular de este estilo de enseñanza porque se enfoca tanto en la legibilidad como en la escritura. Esto garantiza que nuestras bases de código sean amigables para el próximo desarrollador que se presente, incluso si somos nosotros mismos.

Entonces, ¿qué es lo más importante y qué evaluamos exactamente cuando obtenemos un cierto código?. Esto es lo que: su pureza y belleza. La capacidad de escribir código limpio y hermoso es un indicador de la alta profesionalidad del desarrollador.


La enseñanza de esta habilidad se basa en dos componentes: esto es conocimiento y trabajo. El conocimiento te enseña patrones, principios, prácticas, heurísticas. Los necesitas para crecer profesionalmente. Solo este conocimiento debe absorberlo, como una esponja, a través de la práctica constante y el trabajo duro.

En resumen, escribir Clean Code, código limpio en español no es tan simple. Este es un trabajo arduo y difícil, y tendrás que sudar por ello. Mediante prueba y error, mejorará repitiendo los mismos pasos una y otra vez hasta que encuentre la solución que desea. Un camino más simple simplemente no existe. A continuación hay algunos consejos para ayudarlo a aprender a escribir código limpio.

Software Crafters es una web sobre artesanía del software, DevOps y tecnologías software con aspiraciones a plataforma de formación y  consultoría que le ayudara en esta tarea.

Los nombres en el desarrollo de software están en todas partes. Llamamos funciones, clases, argumentos, paquetes, programas, cualquier cosa. Nombramos los archivos y directorios de origen y todo lo relacionado con ellos. Sin cesar nombramos algo, y esto se convierte en una parte esencial de nuestro trabajo en la creación de código limpio. El nombre que le das a algo debe reflejar la intención. Encontrar un buen nombre no es fácil, lleva tiempo, pero también lo guarda cuando tiene que lidiar con el código y la situación se complica. Por lo tanto, tome este proceso con cuidado y no tenga miedo de cambiar los nombres más adelante si logra encontrar uno más adecuado. Todos los que manejen su código se lo agradecerán.

Recuerde que el nombre de cualquier variable, clase, función debe responder tres preguntas principales: por qué existe (una variable, función, etc.), qué hace y para qué se utiliza.

Esto requiere no solo buenas habilidades descriptivas, sino también una erudición general, una perspectiva amplia. Y nadie te enseñará esto mejor que tú mismo. Analicemos para cada elemento individual lo que, de hecho, no es un código limpio. Nuestros ejemplos se referirán a jаvascript.

Números mágicos: Estos son números codificados cuyo significado no está claro. Por primera vez que mira este código, ni siquiera puede imaginar cuál es este número: 86400.

for(let i = 0; i < 86400; i += 1) {
  // ...
}

Será mucho mejor si edita este código escribiendo una constante:

const SECOND_IN_A_DAY = 86400;
 
for(let i = 0; i < SECOND_IN_A_DAY; i += 1) {
  // ...
}

Por lo tanto, cualquier lector sabrá que estamos hablando de la cantidad de segundos en un día. 

A la larga, seguir estas reglas proporciona muchos beneficios. Cuando en unos días, meses o incluso años, alguien se compromete a leer su código, lo revisará rápidamente y dará un suspiro de alivio o decepción. ¿Qué opción prefieres?

El código limpio es fácil de mantener en el futuro, es bueno para cada desarrollador individual y para el equipo en su conjunto. Y es mucho más fácil de leer.

Funciones de código limpio: