El Arte de Nombrar
Escribe nombres que revelen la intención, eviten la confusión y hagan el código buscable.
Revela la Intención
Un nombre debe responder por qué existe, qué hace y cómo se usa — sin necesidad de un comentario.
Oculta la intención
elapsed (days? hours? ms?)
s (score? size? seconds?)
Revela la intención
daysSinceCreation
userScore
Evita la Desinformación
No llames accountList a un HashSet de cuentas. No uses l (parece 1) ni O (parece 0). Un nombre que engaña es peor que ningún nombre.
Haz que las Distinciones Signifiquen Algo
getUser vs getUserInfo vs getUserData — ¿cuál es la diferencia? Si no puedes explicarla, únelos. Palabras de relleno (Info, Data, Manager) añaden longitud, no significado.
Dilo en Voz Alta
Si no puedes pronunciarlo, no puedes discutirlo. ymdhms → timestamp. Los nombres también deben ser buscables — evita variables de una sola letra salvo en contadores de bucle.
Desafío de Código
Edita el código y trata de renombrar todo antes de revelar la versión limpia.
💡Conclusión clave
Un buen nombre es una promesa. Le dice al lector exactamente qué esperar — sin necesidad de comentario.
🔧 Algunos ejercicios pueden tener errores. Si algo parece incorrecto, usa el botón Feedback (abajo a la derecha) para reportarlo — nos ayuda a corregirlo rápido.
Pista: Prueba el test de 'explicar a un colega': describe en voz alta qué representan d, s y tmp en el dominio del negocio. Las palabras que salen naturalmente en esa explicación son los nombres correctos.
✗ Tu versión