Clean Code JavaScript
Guía de referencia para escribir código JavaScript más legible, mantenible y fácil de revisar en equipo.
Adaptación de los principios de Clean Code de Robert C. Martin al ecosistema JavaScript, con ejemplos prácticos del patrón malo y el bueno.
Notas y contexto
Qué es
Traducción práctica del libro “Clean Code” de Robert C. Martin al mundo JavaScript. Cada principio viene acompañado de un ejemplo de código que muestra cómo NO hacerlo y cómo SÍ hacerlo, lo que hace que sea muy fácil de asimilar y de compartir en equipo.
Para qué sirve
- Establecer un lenguaje común de calidad de código en el equipo.
- Aprender a nombrar variables y funciones de forma expresiva.
- Entender cuándo una función es demasiado larga o hace demasiadas cosas.
- Aplicar principios SOLID a JavaScript de forma concreta.
Cuándo usarlo
Es una buena lectura al incorporar a alguien nuevo al equipo o cuando se quiere establecer un estándar de código compartido. También útil como referencia rápida durante code reviews.
Puntos clave
- Cubre nombres, funciones, objetos, clases, SOLID, testing y concurrencia.
- Formato de dos columnas: mal ejemplo vs. buen ejemplo en cada punto.
- Más de 94.000 estrellas en GitHub, ampliamente adoptado como referencia.
- Complemento ideal para una guía de estilo con ESLint.
Ten en cuenta
Algunos ejemplos son opinables y no todos los equipos estarán de acuerdo con cada recomendación. Es mejor tratarlo como punto de partida para una conversación de equipo que como dogma.