Heurísticas de Comentarios
Identifica y elimina los malos comentarios; escribe el raro bueno con precisión.
Los Cinco Malos Olores de Comentarios
C1: Información Inapropiada — usa control de versiones para el historial, no comentarios. C2: Comentario Obsoleto — un comentario desactualizado es peor que ninguno. C3: Comentario Redundante — un comentario que repite el código añade ruido. C4: Mal Escrito — si un comentario vale la pena, escríbelo bien. C5: Código Comentado — elimínalo; git tiene el historial.
Cuándo Comentar
Los buenos comentarios explican el POR QUÉ, no el QUÉ. Los avisos legales, la intención no obvia, los contratos de API pública y los marcadores TODO son aceptables. Todo lo demás es señal de que el código necesita mejorar, no más comentarios.
Desafío de Código
Nombra cada mal olor de comentario (C1–C5) antes de ver la solución.
💡Conclusión clave
Los comentarios no son documentación — son disculpas. Prefiere código expresivo que hable por sí mismo.
🔧 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: C1–C5: Información inapropiada, Obsoleto, Redundante, Mal escrito, Código comentado. Elimina los cinco sin piedad.
✗ Tu versión