MDN (ou plus longuement le « Mozilla Developer Network ») est un wiki, documentant les technologies web. Depuis quelques jours, l’ensemble des sections relatives à HTML, JavaScript et CSS sont intégralement disponibles en français, à jour par rapport à leurs homologues anglaises.

Logo de MDN

MDN est donc un wiki auquel chacun peut contribuer et la documentation qu’il contient pour les technologies web est « agnostique », autrement dit, il ne s’agit pas de documenter uniquement ce qui est pris en charge par Firefox mais bien de servir l’ensemble des développeurs web, quel que soit le navigateur.

Ces sections contiennent 1 749 pages qui décrivent les trois briques fondamentales du Web que sont HTML (Hypertext Markup Language), CSS (Cascading Style Sheets) et JavaScript. Voyons rapidement ce que chacune contient.

HTML

S’il n’en fallait qu’un, ce serait lui. HTML permet de composer un document grâce à des éléments comme <p>, <img>, <a> (qui sert à créer les liens hypertextes qui tissent la toile du Web) et plein d’autres. MDN contient une référence exhaustive qui décrit chaque élément ainsi que les attributs qui permettent de les paramétrer.

Voici un exemple d’un fragment de code HTML d’une page web :

<p> Et voici une bannière intéressante :
  <a href="https://soutien.laquadrature.net/">
    <img src="/img/support_lqdn.png"
             alt="Logo de La Quadrature Du Net pour la campagne de dons" 
             title="Soutenez l'action de La Quadrature Du Net par un don">
  </a>
</p>

Pour les plus nostalgiques des lecteurs, soyez sans crainte, <blink> et <marquee> sont toujours documentés.

La documentation HTML sur MDN

CSS

Le fond, c’est bien, avec la bonne forme, c’est mieux. CSS permet de définir les règles de mise en forme pour les éléments grâce à de nombreuses propriétés, pseudo-classes, pseudo-éléments et autres boîtes et requêtes de média. Chacune des propriétés de la référence est illustrée par un exemple de mise en œuvre et les dernières avancées de ce langage y sont présentées en détails (comme le modèle de grille CSS ou les animations. Il y a même quelques outils destinés à compléter votre arsenal.

Peut-être que, parmi ces 749 pages, vous pourrez trouver comment centrer verticalement une image dans un conteneur…

La documentation CSS sur MDN

JavaScript

Logo JavaScript

Avec bientôt 22 ans au compteur, JavaScript a bien évolué, y compris ces dernières années avec ECMAScript 6 (ou 2015, c’est selon). Sur MDN, ce langage riche, qui ne se cantonne plus au navigateur, est documenté selon plusieurs axes. Il y a tout d’abord un guide dont les 14 chapitres permettent d’appréhender progressivement les concepts de JavaScript. Ensuite, on trouvera la référence, avec une page pour chaque objet, méthode, instruction ou opérateur du langage : cette référence est un outil de précision quand il s’agit de lever le doute sur une imprécision ou un comportement incompréhensible.

Voici un exemple d’un fragment de code JavaScript :

var p1 = Promise.resolve(3);
var p2 = 1337;
var p3 = new Promise((resolve, reject) => {
  setTimeout(resolve, 100, "toto");
});

Promise.all([p1, p2, p3]).then((values) => {
  console.log(values); // [3, 1337, "toto"]
});

La documentation JavaScript de MDN est une des pierres angulaires du wiki et elle est utilisée dans divers outils comme la console de développement ou les aides à l’édition de code. Certes undefined n’est pas une fonction et NaN a un peu de mal à se regarder dans le miroir mais JavaScript ayant conquis de nombreuses plateformes, il n’y a plus tellement d’échappatoires

Note : cette section concerne uniquement le langage JavaScript en tant que tel et non les API web (telles que le DOM, XHR, etc.)

La documentation JavaScript sur MDN

Quelques chiffres

Ce résultat représente environ :

  • plus de 3 ans de travail
  • plus de mots à traduire que les trois tomes du Seigneur des Anneaux (ou que Guerre et Paix, ou que l’intégrale de 50 Nuances de Grey)
  • plus de 13 000 révisions sur MDN (dont de nombreuses mises à jour : imaginez si Tolkien révisait son manuscrit ou ajoutait de nouveaux chapitres)
  • 1 749 pages
CC-BY-SA Goofy©

Contribuer

Au-delà de ces chiffres un peu bêtes, le plus intéressant a été d’apprendre, de découvrir des gens, d’avoir la chance de voyager. Et si la documentation technique peut paraître austère, la rédiger à plusieurs est bien plus agréable. Aussi, n’hésitez pas à contribuer à ce projet. Vous pouvez (sans ordre, ni exhaustivité garantie) :

Si la traduction vous intéresse, je vous invite à lire ce billet et à remplir ce formulaire pour un week-end où vous pourrez mettre le pied à l’étrier.

Remerciements

Si l’introduction d’un livre contient des remerciements, pourquoi n’en irait-il pas de même pour un tel projet ? Naturellement, j’oublierai de nombreuses personnes qui ont participé et qui le méritent, mea culpa.

À ma chère et tendre qui a supporté cette étrange passion et les bruits du clavier, à Goofy et Framasoft qui m’ont lancé sur la traduction collaborative, à Clochix et David pour m’avoir aidé à découvrir MDN, à Jérémie pour les MercrediDoc, à Florian et Jean-Yves pour leur patience, leur aide et leur soutien précieux, à toutes les personnes de la communauté pour les rencontres et les occasions créées…

Merci.