STUPID Indescriptive Naming
Uso de nombres confusos, no representativos, o genéricos para variables, funciones o clases.
Esto ya lo hemos visto en el principio de nombres descriptivos. #
1. Ejemplo Mal #
Cargando actividad al acercarte…
2. Ejemplo Corregido #
Cargando actividad al acercarte…
Resumen del tema
Conceptos clave #
- Nombres Opacos: nombres de una sola letra (
x,y), nombres genéricos (func,doSomething) o de tipo placeholder (foo,bar) que ocultan el significado real. - Identificadores Expresivos: nombres que reflejan el dominio del negocio (
UserNotifier,sendNotification,calculateTotalPrice). - Autodocumentación: un buen nombre evita tener que rastrear la implementación para entender qué hace una función o clase.
Qué debes recordar #
Usa nombres que comuniquen sin ambigüedad la responsabilidad de la clase, el propósito de la función y el contenido de la variable.