DEV Community

gilq
gilq

Posted on

Comentarios en HTML: El diario secreto del desarrollador 📝

¿Alguna vez has abierto un proyecto después de 6 meses y te has preguntado: "¿Qué rayos estaba pensando cuando hice esto?"? Si la respuesta es sí, es porque no usaste suficientes comentarios. Hoy vamos a aprender a escribir notas que el navegador ignora, pero que tus colegas amarán.

🙈 ¿Qué es un comentario?

Un comentario es un bloque de texto que el navegador omite por completo al renderizar la página. No aparece en la pantalla, no ocupa espacio visual, pero vive en el código fuente para guiar a los humanos.

🛠️ ¿Para qué usarlos realmente?

  1. Explicar lógica compleja: "Este div es para el slider de la promo de verano".
  2. Organizar secciones: Marcar dónde empieza el Header y dónde termina el Footer.
  3. Desactivar código temporalmente: Probar cómo se ve la web sin un botón sin tener que borrarlo.

Código: La Sintaxis de la Invisibilidad

<section>
  <h2>Nuestros Servicios</h2>
</section>
<!-- este es un comentario->
<img src="banner.jpg" alt="Promoción">

Enter fullscreen mode Exit fullscreen mode

Tip para el Futuro Senior:

No comentes lo obvio. No escribas `encima de un

`. Los comentarios deben explicar el PORQUÉ, no el QUÉ.

  • Mal: <h1>Hola</h1>
  • Bien: <h1>Hola</h1>

Advertencia: Recuerda que cualquiera puede ver tus comentarios haciendo "Clic derecho > Ver código fuente". ¡No guardes contraseñas ni insultos ahí dentro! 😂

Top comments (0)