CodeForge

Maquetación Web Dinámica / Cómo funciona la Web

Cómo leer documentación (MDN) sin morir en el intento

Teoría15 min20 XP

Este curso no puede enseñarte TODAS las etiquetas y propiedades que existen — nadie las memoriza. Lo que sí puede darte es el superpoder real de los profesionales: saber buscar y entender cualquier respuesta en minutos. Al terminar esta lección, MDN dejará de intimidarte.

MDN: la enciclopedia oficial de la web

MDN Web Docs (developer.mozilla.org) es la documentación mantenida por Mozilla con colaboración de Google, Microsoft y la comunidad. Cuando tengas una duda sobre HTML, CSS o JavaScript, la respuesta confiable está ahí — no en el primer blog que aparezca en Google.

Anatomía de una página de MDN (no se lee entera)

Nadie lee la documentación de arriba abajo. Una página de MDN — por ejemplo, la de la etiqueta <img> — se lee por zonas, y en este orden:

  1. La primera frase: qué es y para qué sirve. A veces con eso basta.
  2. El ejemplo interactivo (arriba): código funcionando que puedes editar.
  3. Los atributos/valores: la lista de opciones disponibles. Se consulta, no se memoriza.
  4. Browser compatibility (al final): qué navegadores lo soportan. Verde = tranquilo, rojo = cuidado.

El flujo de búsqueda profesional

Cuando no sepas cómo hacer algo, este es el camino:

  1. Busca en Google: mdn <lo que buscas> — por ejemplo, mdn img etiqueta. Anteponer mdn filtra el ruido.
  2. Entra al resultado de developer.mozilla.org.
  3. Lee la primera frase y el primer ejemplo. ¿Resuelve? Listo.
  4. ¿No resuelve? Mira la lista de atributos o los enlaces de "See also" — MDN suele enlazar la herramienta correcta cuando llegaste a la vecina.

Un truco de este curso: cada vez que veas una etiqueta o propiedad nueva, abre su página de MDN aunque sea 30 segundos. Ese hábito compuesto te hará autosuficiente mucho antes de terminar el curso.

Encuentras un blog de 2019 y la página de MDN diciendo cosas distintas sobre una etiqueta. ¿A cuál le crees?

Mini-reto

Busca en MDN la etiqueta <marquee>. Lee la advertencia que aparece al principio de la página. Acabas de descubrir tu primera etiqueta obsoleta (deprecated) — y también acabas de usar MDN exactamente como lo usa un profesional: para verificar antes de usar.

Qué sigue

Módulo 1 completo: entiendes el viaje de una petición, tienes tu taller armado, creaste tu primera página y sabes buscar respuestas. En el módulo 2 empieza la construcción en serio: HTML5, el esqueleto de todo lo que ves en la web.