Hay una frase atribuida a Phil Karlton que todo programador termina entendiendo a golpes: “solo hay dos cosas difíciles en informática: la invalidación de caché y nombrar cosas”. Y nombrar es, con diferencia, la que más veces te toca.

El nombre es documentación

Un buen nombre elimina la necesidad de un comentario. Compara:

// días desde el último login
const d = (Date.now() - u.l) / 86400000;

con:

const daysSinceLastLogin = (Date.now() - user.lastLogin) / MS_PER_DAY;

El segundo no necesita explicación. El código se lee muchas más veces de las que se escribe; optimiza para quien lo lee.

Reglas que aplico

  • Evita abreviaturas salvo las universales (id, url, i en un bucle corto).
  • El largo del nombre debe escalar con el alcance. Una variable de tres líneas puede ser x; una global no.
  • Los booleanos se leen como preguntas: isLoading, hasAccess, canEdit.
  • Las funciones son verbos: fetchUser, parseDate, normalizeInput.
  • Sé consistente: si en un sitio es remove, no lo llames delete en otro.

El test rápido

Si necesitas un comentario para explicar qué guarda una variable, probablemente el nombre está mal. Cámbialo antes de añadir el comentario.

Nombrar bien no es estética: es la diferencia entre un código que se mantiene solo y uno que hay que descifrar cada vez.