G16: La Intención Oscurecida
El código que intenta ser inteligente es código que falla en comunicar — la densidad y brevedad a costa de la claridad no son virtudes.
Síntomas de la Intención Oscurecida
G16: El código falla en comunicar cuando la implementación oculta la intención del autor. Síntomas: números mágicos sin nombre; variables de una letra en contextos no triviales; cadenas booleanas excesivamente compactas; trucos bit a bit donde la aritmética sería más clara; expresiones de una sola línea que hacen tres cosas.
La Solución: Exponer el Por Qué
Cada optimización hacia la brevedad que oculta el significado es un déficit neto. La solución: usa constantes nombradas en lugar de números mágicos. Introduce variables explicativas. Expande las expresiones de una sola línea en secuencias de múltiples pasos donde cada paso tiene un nombre significativo. Regla de oro: si tienes que agregar un comentario para explicar una línea, renómbrala o descompónla.
Desafío de Código
Expón la intención nombrando los conceptos enterrados en las expresiones inteligentes.
💡Conclusión clave
G16: El código inteligente solo impresiona a su autor. El código claro sirve a sus lectores — y el código se lee con mucha más frecuencia de lo que se escribe.
🔧 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: Si tienes que explicar una línea con un comentario, renómbrala. Introduce una variable explicativa — el nombre ES la documentación.
✗ Tu versión