20.º aniversario de MDN

• MDN Web Docs celebra su 20.º aniversario y presenta la tradición del pastel de cumpleaños en la industria web
• Existe una tradición en la que los fabricantes de navegadores se envían pasteles entre sí para conmemorar hitos importantes como muestra de colaboración dentro de la competencia
• En este cumpleaños de MDN, recibió felicitaciones con un pastel de regalo del equipo de web.dev
• El desarrollo de MDN ha sido posible gracias al esfuerzo de la comunidad global y de más de 100 mil contribuidores
• También se destaca el esfuerzo continuo hacia el objetivo compartido de fortalecer a los desarrolladores y construir una mejor web

---

Celebrando los 20 años de MDN Web Docs

La tradición del pastel en la industria web

• En el ecosistema web, el pastel de cumpleaños tiene un significado especial
• Las empresas que desarrollan navegadores han mantenido la tradición de regalarse pasteles cada vez que celebran lanzamientos importantes o hitos clave
  • Microsoft incluso le envió pasteles a Mozilla por los lanzamientos de Firefox 2, 3 y 4
  • Mozilla también le envió un pastel a Microsoft por el lanzamiento de IE10
• Esta tradición es un símbolo que refleja muy bien la cultura de desarrollo web donde conviven la competencia y la colaboración

El pastel por el cumpleaños número 20 de MDN

• En este 20.º aniversario de MDN, recibió un pastel de felicitación del equipo de web.dev
• El equipo de MDN agradeció al equipo de web.dev por enviar el delicioso pastel, así como a todos los socios, colegas y miembros de la comunidad que han hecho posible el MDN de hoy

La comunidad de MDN y la colaboración global

• El crecimiento de MDN ha sido impulsado en gran medida por la participación de innumerables desarrolladores y más de 100 mil contribuidores
• Aunque no fue posible mencionar a todas las personas, MDN pudo crecer gracias a su pasión, curiosidad y contribuciones directas

Mirando hacia adelante

• El equipo de MDN reafirma su objetivo de fortalecer a los desarrolladores de todo el mundo y construir juntos una mejor web
• Con base en la experiencia de los últimos 20 años, esperan mantener durante los próximos 20 años el mismo objetivo de colaboración y crecimiento continuos

[GN⁺]

Comentarios de Hacker News

• MDN es sin duda una referencia importante. Documentar tecnologías web modernas tan complejas no es nada fácil, y la verdad lo han hecho muy bien. Pero tengo dos pequeñas reservas. La primera es que a veces leo cosas algo cuestionables en MDN. Por ejemplo, los tutoriales sobre frameworks y librerías de JavaScript no me parecen aportar un valor especial frente a los tutoriales oficiales. En particular, el tutorial de Svelte tiene material de hace 5 años y ya no va con la actualidad. La segunda es que la calidad de la documentación de webextension deja que desear. La mayoría está basada en manifest v2, y lo relacionado con v3 o con compatibilidad con Chrome se menciona de forma incompleta. De hecho, desarrollando con esa documentación terminé pasándome a la documentación oficial de Chrome, incluso cuando mi objetivo principal era Firefox
  • Soy parte del equipo de MDN. ¡Muchas gracias por los elogios y por la retroalimentación! Sin falta voy a compartir esos puntos con el equipo. Si quieres aprender más sobre cómo crear extensiones para Firefox, creo que te puede servir extensionworkshop.com
  • Coincido totalmente en que a veces hay contenido dudoso en MDN. MDN debería durar mucho más que cualquier librería o framework del lado del usuario. Me da curiosidad si Vercel encontrará la forma de atraer usuarios de MDN hacia su propio framework
• Me alegra muchísimo ver que MDN sigue vivo y que continúa actualizándose. Tenía entendido que en 2020 despidieron a todo el equipo, así que me pregunto si después lo volvieron a armar. Enlace a la discusión relacionada en HN
  • Soy parte del equipo de MDN. En ese momento el equipo se redujo temporalmente a dos personas y algunos contratistas, pero ahora ha crecido bastante. Actualmente hay 15 personas entre empleados de tiempo completo, contratistas y una amplia red de socios y colaboradores manteniendo MDN al día. Puedes ver más detalles en nuestro equipo
  • Esta situación de verdad desconcierta. Mozilla despidió a todo el equipo, así que no entiendo por qué un dominio de Mozilla está felicitando el cumpleaños de MDN
  • Una gran parte de la documentación de MDN existe gracias a OpenWebDocs. Ahí participan voluntarios y varias empresas tecnológicas. openwebdocs.org
  • Como el código es abierto, se puede verificar directamente quién está contribuyendo y cómo. Si ves las estadísticas de contribuyentes, parece que muchos de los principales contribuyentes recientes no son empleados de Mozilla, sino gente de Yale, freelancers (probablemente pagados por Mozilla) y personas de distintas empresas
• Gracias a MDN pude crear de adulto un juego tipo Space Invaders, que era un sueño que tenía desde niño. La excelente documentación sobre la Canvas API y OscillatorNode hizo que iniciarme en el desarrollo de juegos fuera realmente sencillo. También pueden ver el juego que hice y la motivación del proyecto
  • Jugarlo estuvo genial. Me gustó cómo progresa: la velocidad de los enemigos, la cantidad, la rapidez con la que bajan, y además fue divertido poder dispararle a las balas enemigas. No sé qué tanto se diferencia del Invaders original, pero fue una experiencia muy buena para una pausa corta. Gracias por compartirlo
  • ¡Qué gusto que MDN haya ayudado a cumplir tu sueño! Sin falta le pasaré ese comentario al equipo
• Llevo casi 20 años usando MDN como mi documentación web de referencia principal. Es un recurso esencial. Es mucho más fácil de leer que la especificación oficial, y además ofrece ejemplos reales, referencias cruzadas e incluso un playground sencillo. Por eso sigue siendo tan útil
• Muchas veces no es fácil aprender una función desconocida en MDN. A veces uno lee la documentación y se pregunta “¿para quién está escrito esto?”. Lees dos párrafos y todavía no te queda claro qué hace esa función ni qué problema intenta resolver. Si no conoces el tema con bastante detalle, terminas de leer y no te llevas casi nada. A veces hasta revisar la especificación da más contexto. Me alegra que MDN exista, pero ojalá tuviera la claridad explicativa de CSS: The Definitive Guide. Yo no pude aprender CSS con la documentación de MDN durante más de un año, pero al leer CSS: The Definitive Guide lo entendí por completo en 3 meses. Si existiera un sistema que mantuviera explicaciones de ese nivel en formato wiki y dejara la información actualizada en las referencias de MDN, yo pagaría por usarlo
  • Soy miembro del equipo de MDN. Muchas gracias por la valiosa retroalimentación. Sin duda la compartiré con el equipo como punto de mejora. Sobre la pregunta de “¿para quién está escrita la documentación?”, la mayoría de nuestras páginas de referencia se crean con base en implementaciones reales de los navegadores. No documentamos solo la especificación, sino que nos enfocamos en funciones adoptadas por distintos navegadores. Intentamos presentar esta información de manera clara y neutral, para que sea accesible a personas en cualquier etapa de desarrollo. A la vez, últimamente también hemos ampliado bastante el contenido de aprendizaje para principiantes. Tenemos currículos que ayudan según la etapa de crecimiento de cada desarrollador, y complementamos los temas más avanzados en el blog
  • Hace 4 o 5 años hubo ejemplos de MDN que no funcionaban en navegadores reales, y como la diferencia entre la función y la palabra clave fit-content se explicaba de forma ambigua, reporté el problema. Después corrigieron la documentación. Pero ahora parece que ya no funciona eso de reportar problemas y que te los corrijan como antes. Hace falta un nuevo canal de retroalimentación o un proceso para arreglarlo. Ejemplo de issue anterior
• Me cuesta entender si de verdad hace falta venir a soltar quejas justo en una publicación conmemorativa sobre un servicio gratuito. Llevo más de 5 años usando la documentación de MDN y es un recurso valiosísimo, además de que me ha llevado de forma natural a experimentar con muchas cosas. Gracias a MDN descubrí APIs y funciones geniales que nunca habría conocido si no las hubiera ido a buscar. Felices 20 años
  • Esto me recuerda a la frase de Stroustrup sobre que solo existen los lenguajes de los que la gente se queja y los que nadie usa. Como MDN es un servicio realmente necesario, mucha gente tiene opiniones muy distintas al respecto. Yo trabajo un poco con la plataforma web, pero la documentación de MDN siempre me ha parecido más fresca que otras
• MDN es un recurso realmente útil. En los últimos 15 años habré usado al menos una vez al mes el comando !mdn Array en DuckDuckGo
  • La comunidad también creó el redirect mdn.io/array, ¡así que también lo puedes aprovechar!
• Me pregunto si hay alguna forma de apoyar económicamente a MDN directamente. No me refiero a donar a Mozilla en general, sino a hacer una donación etiquetada para que se use claramente en la operación de MDN. Así de indispensable es para mí MDN
  • Con Firefox me pasa lo mismo: dependo de él todos los días. Pero cada vez me decepciona más Mozilla como organización. Me frustró ver cómo desvían recursos a cosas que no tienen que ver con Firefox, y no tengo intención de aportar más apoyo hasta que alineen mejor sus prioridades
• Uso muchísimo MDN. Si el equipo llega a leer este comentario, quisiera compartir que la documentación de SVG me resultó algo incómoda. Las descripciones de los elementos SVG se sienten demasiado escuetas. Por ejemplo, en la página de explicación del elemento g, faltan enlaces o explicaciones concretas sobre qué atributos se pueden usar y cuáles son los atributos globales. En la página debería ser fácil ubicar la lista de atributos, pero uno tiene que ir a buscarla por su cuenta y eso es incómodo. Si haces clic en "attributes" aparece la lista completa, pero no queda claro cuáles son globales. Ese modo de organizarlo no me resulta natural, y si fuera documentación tipo estructura de API, esperaría que cada propiedad se explicara en la misma página de esa estructura. Como en la documentación de HTMLCanvasElement, al menos me gustaría que los atributos propios y los heredados de cada elemento estuvieran resumidos de un vistazo. Parece que una buena parte de esto se podría semiautomatizar con IDL
• La primera vez que conocí MDN fue como colarme en el archivo secreto de un mago para leer libros antiguos. Equipo de Mozilla, de verdad hacen un trabajo increíble