Les 20 ans de MDN

• MDN Web Docs fête ses 20 ans et revient sur la tradition des gâteaux d’anniversaire dans l’industrie du web
• Les éditeurs de navigateurs ont pour tradition de s’envoyer des gâteaux pour célébrer les grands jalons, afin de marquer une coopération dans la concurrence
• Pour cet anniversaire de MDN, l’équipe web.dev a offert un gâteau pour l’occasion
• L’évolution de MDN doit beaucoup aux efforts de la communauté mondiale et de plus de 100�0 contributeurs
• MDN souligne sa volonté de continuer à poursuivre un objectif commun : renforcer les développeurs et construire un meilleur web

---

Les 20 ans de MDN Web Docs

La tradition des gâteaux dans l’industrie du web

• Dans l’écosystème du web, le gâteau d’anniversaire a une signification particulière
• Les éditeurs de navigateurs perpétuent la tradition de s’offrir des gâteaux pour célébrer les lancements majeurs et jalons importants
  • Microsoft a notamment envoyé des gâteaux à Mozilla à la sortie de Firefox 2, 3 et 4
  • Mozilla a aussi envoyé un gâteau à Microsoft pour la sortie d’IE10
• Cette tradition symbolise bien une culture du développement web où coexistent concurrence et collaboration

Le gâteau du 20e anniversaire de MDN

• Pour les 20 ans de MDN, l’équipe web.dev a envoyé un gâteau de célébration
• L’équipe de MDN remercie l’équipe web.dev pour ce délicieux gâteau, ainsi que tous les partenaires, collègues et membres de la communauté qui ont permis à MDN de devenir ce qu’il est aujourd’hui

La communauté MDN et les partenariats mondiaux

• Le développement de MDN doit beaucoup à l’activité de nombreux développeurs et de plus de 100�0 contributeurs
• Beaucoup d’autres personnes n’ont pas pu être mentionnées individuellement, mais MDN a pu grandir grâce à leur passion, leur curiosité et leurs contributions directes

Les engagements pour la suite

• L’équipe MDN réaffirme son objectif de renforcer les capacités des développeurs du monde entier et de construire ensemble un meilleur web
• Forte de l’expérience des 20 dernières années, elle espère poursuivre, au cours des 20 prochaines années, la collaboration continue et la croissance autour du même objectif

[GN⁺]

Avis sur Hacker News

• MDN est clairement une ressource de référence importante. Documenter des technologies web modernes aussi complexes n’est pas une tâche facile, et ils ont vraiment fait du bon travail. J’ai quand même deux petits regrets. D’abord, il m’arrive parfois de lire sur MDN des contenus un peu discutables. Par exemple, le tutoriel sur les frameworks et bibliothèques JavaScript, à mon avis, n’apporte pas de valeur particulière par rapport aux tutoriels officiels. Le tutoriel Svelte en particulier date de 5 ans et n’est plus vraiment adapté à aujourd’hui. Ensuite, je trouve dommage que la qualité de la documentation sur les webextensions soit faible. Elle repose en grande partie sur manifest v2, et ce qui concerne v3 ou la compatibilité Chrome n’est mentionné que de manière incomplète. En pratique, j’ai commencé avec cette documentation puis j’ai dû basculer vers la documentation officielle de Chrome, alors même que Firefox était ma cible principale
  • Je fais partie de l’équipe MDN. Merci beaucoup pour les compliments et pour le retour ! Je vais absolument transmettre ces remarques à l’équipe. Si vous voulez en apprendre davantage sur la création d’extensions Firefox, extensionworkshop.com pourrait vous être utile
  • Je suis tout à fait d’accord sur le fait qu’il y a parfois du contenu discutable sur MDN. MDN doit survivre bien plus longtemps que les bibliothèques ou frameworks côté utilisateur. Je me demande si Vercel va trouver un moyen de faire venir les utilisateurs de MDN vers son propre framework
• Je suis vraiment heureux de voir que MDN existe toujours et continue d’être mis à jour. Je croyais que toute l’équipe avait été licenciée en 2020, donc je me demande s’ils ont reconstitué une équipe depuis. Lien vers la discussion HN associée
  • Je fais partie de l’équipe MDN. À l’époque, l’équipe avait temporairement été réduite à deux personnes et quelques prestataires, mais elle s’est depuis considérablement développée. Aujourd’hui, 15 employés permanents, contractuels, ainsi qu’un large réseau de partenaires et de contributeurs maintiennent MDN à jour. Vous trouverez plus d’informations sur la présentation de notre équipe
  • Cette situation est vraiment déroutante. Mozilla a licencié toute l’équipe, alors je ne comprends pas pourquoi un domaine Mozilla fête l’anniversaire de mdn
  • Une grande partie de la documentation MDN existe grâce à OpenWebDocs. C’est géré collectivement par des bénévoles et plusieurs entreprises technologiques. openwebdocs.org
  • Comme le code est ouvert, on peut aller voir directement qui contribue et comment. En consultant les statistiques des contributeurs, on a l’impression que beaucoup des principaux contributeurs récents ne sont pas des employés de Mozilla, mais plutôt des personnes de Yale, des freelances (probablement rémunérés par Mozilla) et des participants venant de diverses entreprises
• Grâce à MDN, j’ai pu créer à l’âge adulte un jeu de type Space Invaders dont je rêvais enfant. Grâce aux excellentes documentations sur l’API Canvas et sur OscillatorNode, il a été très facile de se lancer dans le développement de jeux. Voir aussi le jeu que j’ai créé et la motivation du projet
  • Le gameplay était vraiment excellent. Le rythme de progression, la vitesse et le nombre des ennemis, ainsi que leur descente, étaient bien pensés, et le fait de pouvoir tirer sur les balles ennemies était amusant. Je ne sais pas exactement à quel point cela diffère de l’Invaders original, mais c’était une super expérience pour une courte pause. Merci
  • Je suis vraiment heureux que MDN vous ait aidé à réaliser votre rêve ! Je transmettrai votre retour à l’équipe
• Cela fait près de 20 ans que j’utilise MDN comme documentation web de référence principale. MDN est une ressource essentielle. C’est bien plus facile à lire que les spécifications officielles, et cela fournit des exemples concrets, des références croisées et même un petit playground. C’est ce qui en fait une ressource constamment utile
• J’ai souvent du mal à apprendre une fonctionnalité inconnue sur MDN. En lisant certaines pages, je me demande parfois : « mais à qui est-ce censé s’adresser ? » Même après deux paragraphes, on ne comprend pas forcément ce qu’est la fonctionnalité ni quel problème elle cherche à résoudre. Si l’on ne connaît pas déjà le sujet dans le détail, on ressort de la lecture sans grand-chose. Parfois, consulter directement la spécification apporte même davantage de contexte. Je suis heureux que MDN existe, mais j’aimerais que ce soit aussi clair dans ses explications que CSS: The Definitive Guide. Je n’ai pas réussi à apprendre le CSS avec la documentation MDN pendant plus d’un an, puis après avoir lu CSS: The Definitive Guide, j’ai tout compris en trois mois. S’il existait un système qui conserve en style wiki des explications de ce niveau tout en gardant les informations à jour à partir des références MDN, je paierais volontiers pour l’utiliser
  • Je fais partie de l’équipe MDN. Merci beaucoup pour ce retour utile. Je vais le partager avec l’équipe pour que cela nous aide à progresser. Quant à la question « à qui s’adresse cette documentation ? », la plupart de nos pages de référence sont fondées sur les implémentations réelles des navigateurs. Nous ne documentons pas seulement les spécifications : nous nous concentrons sur les fonctionnalités effectivement introduites dans plusieurs navigateurs. Nous essayons de présenter ces informations de manière claire et neutre, afin qu’elles soient accessibles à n’importe quel stade du parcours d’un développeur. En parallèle, nous avons récemment beaucoup développé le contenu d’apprentissage pour les débutants. Nous proposons des parcours de formation utiles selon les étapes de progression des développeurs, et nous complétons les sujets avancés sur le blog
  • Il y a 4 ou 5 ans, certains exemples de MDN ne fonctionnaient pas réellement dans les navigateurs, et l’explication de la différence entre la fonction et le mot-clé fit-content était ambiguë, donc j’ai ouvert un ticket. La documentation a ensuite été corrigée. Mais aujourd’hui, il semble qu’on ne puisse plus signaler un problème et obtenir une correction de la même manière. Il faudrait un nouveau canal de retour ou un nouveau processus de correction. Exemple d’ancien ticket
• Je trouve étrange qu’on ressente le besoin d’exprimer des plaintes dans un commentaire d’anniversaire alors qu’il s’agit d’un service gratuit. J’utilise la documentation MDN depuis plus de 5 ans, et c’est une ressource très précieuse qui m’a aussi naturellement poussé à expérimenter toutes sortes de choses. Grâce à MDN, j’ai découvert de super API et fonctionnalités que je n’aurais jamais connues si je n’avais pas cherché. Bon 20e anniversaire
  • Cela me rappelle la phrase de Stroustrup selon laquelle « il n’existe que deux types de langages : ceux dont les gens se plaignent et ceux que personne n’utilise ». Si autant de personnes ont des avis variés, c’est bien parce que MDN est vraiment nécessaire. Je travaille un peu avec la plateforme web, et j’ai toujours trouvé que la documentation MDN gardait quelque chose de rafraîchissant par rapport aux autres
• MDN est une ressource vraiment utile. Depuis 15 ans, j’utilise au moins une fois par mois la commande DuckDuckGo !mdn Array
  • La communauté a aussi mis en place la redirection mdn.io/array, donc ça peut servir !
• Je me demande s’il existe un moyen de soutenir directement MDN. Je ne parle pas de faire un don à Mozilla dans son ensemble, mais de pouvoir affecter clairement ce don au fonctionnement de MDN. MDN est à ce point indispensable pour moi
  • C’est pareil pour Firefox, dont je dépends aussi chaque jour. Mais ma déception envers l’organisation Mozilla ne cesse de grandir. Je suis déçu de la manière dont elle détourne des ressources vers des choses sans lien avec Firefox, et tant que les priorités ne seront pas réalignées, je ne compte pas donner davantage
• J’utilise vraiment beaucoup MDN. Si l’équipe lit ce commentaire, j’aimerais partager une expérience un peu frustrante avec la documentation SVG. Les explications sur les éléments SVG m’ont semblé trop légères. Par exemple, pour l’élément g, la page de description n’indique pas clairement quels attributs sont disponibles ni ce que sont les attributs globaux, avec suffisamment de liens ou d’explications concrètes. On devrait pouvoir identifier facilement la liste des attributs sur la page, mais il faut aller les chercher soi-même, ce qui est fastidieux. Quand on clique sur « attributes », on obtient bien la liste complète, mais sans que les attributs globaux soient clairement distingués. Cette manière d’organiser l’information ne m’est pas familière et, pour une documentation de type structure d’API, je m’attendrais à ce que chaque propriété soit expliquée sur la page de cette structure. Comme pour la documentation de HTMLCanvasElement, j’aimerais au minimum que les attributs propres à chaque élément et les attributs hérités soient récapitulés d’un seul coup d’œil. Une bonne partie de cela pourrait probablement être semi-automatisée à partir de l’IDL
• Quand j’ai découvert MDN pour la première fois, j’avais l’impression d’entrer en cachette dans le sanctuaire secret d’un magicien pour y consulter des grimoires. L’équipe Mozilla fait vraiment quelque chose de formidable