Mettre en place son dépôt bifurqué

Ce guide vous présent la méthode de contribution au MDN par le biais de modification des pages Markdown en utilisant l'interface de Github. Les dépôts sont bifurqués pour permettre à chacun de faire des modifications sans impacter le dépôt principal avec des actions potentiellement dangereuses.

Comprendre la structure du MDN

Le MDN est divisé en plusieurs dépôts qui constituent chacun une partie fonctionnelle du site final. Pour pouvoir contribuer au MDN, vous avez besoin des dépôts essentiels qui sont tous regroupés sur GitHub pour permettre la contribution collaborative visant à améliorer ces outils.

Le MDN que vous visitez tous les jours est composé ainsi :

Historiquement, le MDN fonctionnait sur une version de MediaWiki, nommé Kuma. C'est de ce nom que les macros du MDN proviennent à la base, Kumascript. Le 14 décembre 2020 a été lancé Yari, le remplaçant de Kuma. Cela a changé l'utilisation de la plateforme pour les traductions, puisque qu'il n'était plus nécessaire de passer par une interface web, tout se passait dans des fichiers HTML hébergés dur GitHub directement. Les locales de catégories 1 ont reçu leurs accréditations pour pouvoir modifier leurs pages et reprendre les traductions le 20 mars 2021.

Les locales de catégories 2 ont rejoint le groupe de travail pour passer de 4 langues traduites (Français, Japonnais, les deux langues chinoises) à 8 langues en ajoutant l'Espagnol, le Coréen, le Portugais brésilien et le Russe.

Durant l'année 2022, les pages ont progressivement été remplacées par du Markdown, qui est le langage globalement utilisé dans les pages du MDN. Cela rend les pages plus digestes à traduire et modifier, et moins contraignante à paramétrer par rapport au HTML.

En 2024, un nouveau système d'exemple interactif a fait son apparition pour remplacer l'ancien système qui nécessitait de mettre les exemples dans un dépôt GitHub. Maintenant, tous les exemples sont directement intégrés en haut des pages pour les sections concernées, ce qui a également permis d'étendre le nombre d'exemples introductif dans des sections qui n'en avaient pas.

En août 2025, les fonctionnalités de Yari ont été remplacées par Rari, nouveau moteur, nouveau fonctionnement, avec cela, la partie avant a été séparée et nommée Fred qui est un diminutif pour Fr(ont)-e(n)d. Rari est écrit en Rust et est ajouté dans Fred comme une dépendance directe. Vous n'avez plus à vous soucier d'une partie du travail que le serveur local fait, et ce dernier démarre plus rapidement.

remarque

Yari est toujours existant, même s'il n'est plus utilisé comme un outil ; en août 2025, il a été remplacé par Fred ; en septembre 2026, il est officiellement devenu une dépendance en lecture seule puisqu'il est toujours utilisé dans le MDN.

Bifurquer le dépôt principal

La bifurcation (fork en anglais) est une opération qui consiste à créer une copie profonde d'un dépôt pour apporter ses améliorations, tester dans son environnement local, développer sa fonctionnalité, avant même de proposer les modifications pour le fusionner dans le dépôt principal.

Voici les étapes à suivre pour bifurquer un dépôt, nous allons utiliser le dépôt des traductions du MDN comme exemple :

1. Pour bifurquer le dépôt du MDN, rendez-vous sur la page de ce dernier et cliquez sur le bouton Fork situé en haut à droite de la page.

   

2. Une fois cliqué, vous devrez compléter un formulaire pour intégrer le dépôt dans votre compte Github comme copie, le nommer (si vous souhaitez changer son nom) et choisir si vous souhaitez copier toutes les branches ou seulement la branche principale (ce que nous recommandons).

   

3. Une fois effectué, vous pourrez naviguer dans le dépôt pour modifier la page que vous souhaitez.

   • Les pages sont rangées dans les dossiers files/fr/, ce qui rend les différentes catégories très structurées et faciles à naviguer.

     Structure du dépôt

     📂 files
     │  …
     ├─ 📂 fr
     │  ├─ 📁 games
     │  ├─ 📁 glossary
     │  ├─ 📁 learn_web_development
     │  ├─ 📁 mdn
     │  ├─ 📁 mozilla
     │  ├─ 📁 web
     │  └─ 📁 webassembly
     └─ …

   • Les pages sont rangées de la même manière que le chemin qui est écrit à l'intérieur du fichier. Par exemple si vous cherchez l'attribut universel HTML title :

     Structure vers « files/fr/web/html/reference/global_attributes/title/index.md »

     📂 files/fr
     └─ 📁 web
        └─ 📁 html
           └─ 📁 reference
              └─ 📁 global_attributes
                 └─ 📁 title
                    └─ 📄 index.md <- Ceci est le fichier qui décrit `title`

   • Pour retrouver rapidement la page, vous pouvez aller sur elle directement la page avec « Voir cette page sur Github » et ouvrir sa version Github en bas de page. Attention, vous serez redirigé sur le dépôt principal, il faudra changer le début du lien par le lien de votre dépôt bifurqué.

     

Félicitation, vous avez maintenant une copie du dépôt d'origine. Dans notre guide sur les méthode avancées, nous voyons comment ajouter le dépôt distant comme lien dans votre gestion des dépôts locaux pour pouvoir travailler avec le dépôt d'origine et votre dépôt bifurqué.

Proposer des modifications

1. Une fois que vous êtes dans la page de votre dépôt bifurqué, vous pouvez cliquer sur le petit crayon (  ) pour éditer la page.

2. Modifiez le contenu que vous souhaitez changer puis, une fois que vous avez terminé, cliquez sur le bouton Propose changes pour proposer vos modifications. Un formulaire s'affiche pour vous demander le titre de votre instantané de modification. Nous recommandons d'utiliser les titres standardisés comme chore(fr): description courte pour des modifications de la documentation ou fix(fr): description courte lorsque vous corrigez des erreurs. Nommer de cette manière respecte les conventions de nommages des instantanés de modification ^(angl.).

   Une fois la description courte écrite, vous devez choisir de « Créer une nouvelle branche » et la nommer. Si vous souhaitez vous retrouver entre vos branches, pensez à leur donner un nom facile à comprendre.

   attention

   Vous ne devez jamais modifier le contenu de la branche main, c'est pourquoi lorsque vous enregistrez la modification, vous créez une nouvelle branche. Comme ça, vous bifurquez la branche principale vers une version modifiée qui n'impacte pas la branche principale. Cela vous permet de garder la branche main à jour et l'actualiser à chaque fois que vous voulez mettre à jour votre dépôt bifurqué ou faire une nouvelle modification.

3. Une fois tout complété, vous pouvez retourner sur le dépôt principal pour créer une requête de tirage (pull request en anglais) afin d'intégrer vos modifications dans le MDN. Si vous le faites directement après avoir enregistré la modification, un bandeau jaune s'affiche pour ouvrir directement la requête. Sinon, vous pouvez cliquer sur l'onglet Pull requests du dépôt principal et cliquer sur le bouton New pull request pour créer une nouvelle requête de tirage.

   

   info

   Il est important de bien compléter la description qui vous sera générée pour que l'équipe de relecture puisse comprendre les motivations derrière votre proposition.

Une fois cela effectué, vous pouvez continuer d'utiliser votre dépôt bifurqué pour modifier d'autres pages. Partez toujours de la branche principale (main) pour créer les branches de vos modifications.

Il ne vous reste plus qu'à attendre d'un membre de l'équipe de relecture vienne examiner votre requête, la corriger et la valider. Dans le cas où des erreurs seraient à corriger, vous aurez une liste des modifications nécessaires, à appliquer.

Résumé

Nous avons vu dans ce guide comment mettre en place son dépôt bifurqué et comment contribuer en effectuant des modifications sur les pages depuis Github. À partir d'ici, vous pouvez faire des petites modifications pour mettre à jour ou corriger les pages du MDN. Pour effectuer des opérations plus complexes, nous vous invitons à lire le guide suivant qui vous apprendra à créer des pages, ajouter des images et utiliser un environnement local.