La plate-forme de référence des standards Web MDN de Mozilla passe à GitHub, désormais en version bêta

La documentation de référence sur MDN JavaScript et la technologie Web de Mozilla migre vers une nouvelle plate-forme basée sur GitHub, nommée Yari, qui est maintenant en version bêta et prend des contributions.

Contrairement à la plupart des plates-formes de développement, il n’existe pas de source officielle unique de documentation pour la concoction de JavaScript, HTML et CSS utilisés pour coder des pages Web.

Il existe une norme officielle ECMAScript, diverses normes W3C à différents stades de recommandation, d’autres normes au WHAT WG (Web Hypertext Application Working Group) et une documentation pour les moteurs de navigateur, à savoir principalement Blink (Chromium), WebKit (Safari) et Gecko de Mozilla ou Quantum, ainsi que les environnements d’exécution JavaScript V8, SpiderMonkey et JavaScriptCore d’Apple.

Le résultat est que lorsqu’un développeur malchanceux tape quelque chose comme “comment rechercher un tableau JavaScript” dans un moteur de recherche, il est susceptible de trouver (à côté des blogs et des articles StackOverflow) des informations de référence sur deux sites, w3schools et le MDN de Mozilla. W3schools n’est pas connecté avec le W3C, prend de la publicité et s’adresse aux apprenants, bien qu’il s’agisse d’un site bien présenté et souvent utile. MDN est plus détaillé, plus technique et généralement préféré par les développeurs professionnels. Les deux sites incluent les tableaux de compatibilité des navigateurs cruciaux qui indiquent aux développeurs s’ils peuvent utiliser de manière réaliste une fonctionnalité intéressante.

MDN est donc important, donc en cas de problème avec Mozilla licencié de nombreux membres de l’équipe de documentation MDN en août, cela a provoqué la consternation parmi les développeurs Web. À l’époque, le PDG de Mozilla, Mitchell Baker, écrivait vaguement au sujet d’un «nouvel accent sur le produit» tout en informant également les employés d’une réduction des effectifs d’environ 250 personnes.

Il était évident que pour que MDN continue, cela nécessite plus de contributions volontaires qu’auparavant et le rédacteur technique principal Chris Mills a lancé un “appel à la participation” le mois dernier. Il a également déclaré que MDN migrait vers GitHub, le contenu actuellement dans une base de données MySQL étant déplacé vers un référentiel Git, le projet Yari susmentionné.

Plus de détails sont arrivés la semaine dernière et hier Yari est entré en version bêta et son référentiel est maintenant public. Mills a déclaré que “la forme exacte de la plate-forme n’a pas encore été finalisée” mais aussi que “la première version aura lieu le 14 décembre”. L’équipe doit avoir une confiance considérable dans la version bêta pour livrer la version 1.0 en seulement six semaines.

Mills a déclaré que la plate-forme existante est “complexe et difficile à maintenir” et que Yari sera plus simple à gérer. Cela fait également passer MDN d’un modèle Wiki à un modèle basé sur des requêtes d’extraction, ce que Mills a qualifié de “bien meilleur pour la contribution”, l’une des raisons étant que les contributeurs peuvent modifier en utilisant l’éditeur de code de leur choix. Cela signifie également que les modifications de contenu sont examinées avant l’approbation, contrairement à l’approche Wiki où elles apparaissent instantanément et sont annulées si quelqu’un remarque une erreur ou un spam.

Le nouveau MDN sera déployé sur la plate-forme d’Amazon à l’aide d’un modèle Jamstack, où les sites Web sont composés de fichiers statiques complétés par des services appelés à partir de JavaScript pour un contenu dynamique. Un processus quotidien déploiera le contenu de GitHub vers AWS S3, où il sera servi aux utilisateurs via un CDN (réseau de diffusion de contenu). AWS Lambda sera utilisé pour le contenu dynamique, avec un cluster Kubernetes avec des données dans MySQL pour les services de compte et de recherche. ElasticSearch est également utilisé dans le cadre du processus de création d’index. Le MDN existant utilise Kubernetes et MySQL pour tout le contenu, de sorte que le nouveau cluster Kubernetes est “radicalement plus petit” que le précédent. En juillet, Mills a déclaré que MDN attirait “environ 15 millions de vues par mois”.

Mozilla a également créé un nouveau Sass (pré-processeur CSS) pour MDN, appelé mdn-minimalist, qui est utilisé pour le style. Mills a déclaré que de nombreux problèmes d’accessibilité seront résolus par la nouvelle conception.

La traduction et la localisation sont un autre domaine délicat, encore une fois limité par les ressources limitées des employés. Bien qu’il semble qu’aucune décision finale n’ait été prise, il est prévu d’utiliser des «traductions automatisées basées sur l’apprentissage automatique» pour le contenu MDN le plus important et de permettre aux membres de la communauté d’améliorer manuellement la traduction automatique.

Mills a déclaré que “les traductions automatiques sont une solution acceptable dans la plupart des cas, sinon parfaite”. Lors des tests, Mills a déclaré que les utilisateurs préféraient le contenu mal traduit mais à jour à une meilleure traduction du contenu obsolète. Dans la pratique, les utilisateurs peuvent également se tourner vers des services comme Google Translate ou Microsoft Translator pour obtenir du contenu dans leur langue – bien que la traduction automatique soit dangereuse en matière de contenu technique car la précision est requise.

La question inconnue est de savoir dans quelle mesure MDN attirera les ressources dont il a besoin pour maintenir ses bons résultats. Mozilla fournit la plate-forme, mais elle nécessitera toujours une contribution importante de la communauté pour que le projet Yari atteigne ses objectifs. ®