📌Mejorar Nombres

📚 Reglas Generales

• Las variables deben estar en inglés y ser pronunciables.

• Evitar guiones bajos excepto en ciertos casos, como en Python donde se prefiere el snake_case.

• Para nombres de clases o interfaces, usar UpperCamelCase.

• No ahorrar caracteres: los nombres deben ser expresivos.

🚫 Ejemplos de lo que NO hacer

• const n = 53 ➡️ ¿Qué significa "n"? Es poco claro.

• const tx = 0.15 ➡️ "tx" podría confundirse fácilmente. Mejor usar const tax = 0.15.

• const cat ➡️ Puede ser "categoría" o "gato". Ambiguo.

• Fechas como ddmmyyyy ➡️ No es claro qué representa.

✅ Ejemplos de Mejores Prácticas

• const numberOfUnits = 53 ➡️ Claridad sobre lo que representa la variable.

• const tax = 0.15 ➡️ Directo y comprensible.

• const birthDate = "01011990" ➡️ Claramente la fecha de nacimiento.

🤖 Evitar Información Técnica en Nombres

• Los nombres no deben revelar detalles técnicos innecesarios, como:

  • class AbstractUser ➡️ Mejor class User si el contexto de abstracción ya es claro.

  • interface UserInterface ➡️ Redundante. Usar simplemente interface User.

📏 Nombres Largos vs. Ofuscación

🧐 Importancia de Nombres Largos

• Utilizar nombres largos y descriptivos es preferible para la claridad del código.

• Ejemplos:

  • const elapsedTimeInDays = 23 en lugar de const d = 23.

  • const maxClassesPerStudent = 6 en vez de una abreviatura críptica.

💻 Ofuscación de Código

• La preocupación por el peso del archivo debido a nombres largos es común, pero:

  • La mayoría de los lenguajes de programación y herramientas (bundlers) modernos ofuscan el código al compilarlo o prepararlo para producción.

  • Este proceso de ofuscación reduce el tamaño del archivo y optimiza los nombres de las variables para la ejecución, sin afectar la legibilidad del código fuente.

🚀 Conclusión sobre Nombres y Ofuscación

• Prioriza la Legibilidad: Siempre elige nombres claros y expresivos para tus variables y funciones.

• No Temas a los Nombres Largos: Las herramientas modernas de desarrollo se encargan de optimizar el código para la ejecución.

• Legibilidad sobre Minimalismo en Nombres: Un buen nombre reduce la necesidad de comentarios y hace el código más accesible para ti y para otros desarrolladores.