Clean Code

Post en desarrollo...

💸Deuda técnica

¿Cómo se paga la deuda técnica?

Refactorización: Es un proceso que tiene como objetivo mejorar el código sin alterar su comportamiento para que sea más entendible y tolerante a cambios. Es imprescindible contar con pruebas automáticas.

🖌Clean Code

Recomendaciones para nombres de variables

  • Expresivos
  • Pronunciables
  • Escritos en inglés
  • Usar camelCase

Ejemplos según el tipo de dato

Arrays

const fruitNames = ['apple', 'banana', 'orange'];

Booleans

const isOpen = true;
const canWrite = true;
const hasValues = false;

Number

const maxFruits = 5;
const minFruits = 1;
const totalOfCars = 10;

Function (que el nombre diga exactamente que hace la función)

createUser();
updateUser();
sendEmail();
getEmail();

Recomendaciones para funciones

  • Simplicidad es fundamental
  • Funciones de tamaño reducido
  • Funciones de una sola línea sin causar complejidad
  • Menos de 20 líneas
  • Evitar el uso del “else”
  • Prioriza el uso de la condicional ternaria

Principio DRY (Don’t repeat yourself)

  • Evitar tener duplicidad de código
  • Simplifica pruebas
  • Centraliza los procesos
  • Aplicar el principio DRY, usualmente lleva a refactorizar

Comentarios

“No comentes el código mal escrito, reescríbelo” -Brian W. Kernighan

Nuestro código debe ser suficientemente auto explicativo, podemos usar comentarios cuando usamos librerías de terceros en caso de ser necesario explicar algo.

Uniformidad en el proyecto

Problemas similares, soluciones similares.

  • Estructuras de directorios
  • Nombres de funciones
  • Indentación