convert content to md

16 files changed, 1055 insertions, 1133 deletions

diff --git a/files/fr/mdn/contribute/documentation_priorities/index.md b/files/fr/mdn/contribute/documentation_priorities/index.md
index 9f56f5fcaa..1dee08a75c 100644
--- a/files/fr/mdn/contribute/documentation_priorities/index.md
+++ b/files/fr/mdn/contribute/documentation_priorities/index.md
@@ -9,214 +9,179 @@ tags:
   - Priorities
 translation_of: MDN/Contribute/Documentation_priorities
 ---
-<p>{{MDNSidebar}}</p>
-
-<p>Ce document définit les différents niveaux de priorité sur MDN, et indique quels sujets de documentation existent dans chaque niveau - nous les catégorisons entre <strong>Niveau 1</strong> et <strong>Niveau 2</strong>.</p>
-
-<p>L'objectif de ce document est double :</p>
-
-<ul>
-  <li>Aider à appliquer des mesures de priorité aux bogues de contenu pendant notre processus de triage, ce qui aide les contributeurs à prendre une décision sur les bogues sur lesquels travailler en découvrant ceux qui sont les plus importants pour le moment.</li>
-  <li>Aider les contributeurs qui souhaitent travailler sur un sujet spécifique (plutôt que sur un bogue particulier) à décider du sujet où il serait le plus utile de consacrer du temps (par exemple, pour les personnes qui aiment exécuter des scripts de nettoyage automatique sur MDN).</li>
-</ul>
-
-<p>L'importance relative de ces documents a été déterminée uniquement en fonction du nombre de pages vues. Il y a beaucoup de mesures que nous aurions pu utiliser, mais le nombre de pages vues est objectif et reste un bon indicateur. Les technologies web les plus importantes sont consultées plus souvent et, par conséquent, la résolution des problèmes liés à ces documents semble la plus importante.</p>
-
-<p>Gardez également à l'esprit que ces niveaux sont constitués d'arborescences de documents isolés (c'est-à-dire la page liée, plus tous les documents de la hiérarchie qui lui sont inférieurs). Il arrive qu'un document de niveau 1 soit lié à un document de niveau 2, ou vice versa, et c'est normal.</p>
-
-<p>Les chiffres entre parenthèses après chaque arbre de documents représentent le nombre de documents sous cet arbre pour l'anglais. Ces chiffres sont susceptibles de changer au fil du temps, et il faudra peut-être les revoir avant longtemps.</p>
-
-<h2 id="tier_1">Niveau 1</h2>
-
-<p>Le contenu de niveau 1 est le plus important sur MDN : il compte le plus grand nombre de lectrices et lecteurs. Il est censé couvrir les technologies les plus importantes pour la plateforme web.</p>
-
-<ul>
-  <li><a href="/fr/docs/Web/Accessibility">Accessibilité</a> (104)</li>
-  <li><a href="/fr/docs/Web/CSS">CSS : Feuilles de style en cascade</a> (933)</li>
-  <li><a href="/fr/docs/Web/Events">Événements</a> (4)</li>
-  <li><a href="/fr/docs/Web/HTML">HTML : HyperText Markup Language</a> (239)</li>
-  <li><a href="/fr/docs/Web/HTTP">HTTP</a> (292)</li>
-  <li><a href="/fr/docs/Web/JavaScript">JavaScript</a> (921)</li>
-  <li><a href="/fr/docs/Learn">Apprendre le développement web</a> (355)</li>
-  <li><a href="/fr/docs/Web/Media">Médias sur le Web</a> (17)</li>
-  <li><a href="/fr/docs/Web/Performance">Performance</a> (16)</li>
-  <li><a href="/fr/docs/Web/Privacy">Vie privée</a> (1)</li>
-  <li><a href="/fr/docs/Web/Progressive_web_apps">Applications web progressives</a> (16)</li>
-  <li><a href="/fr/docs/Web/Security">Sécurité</a> (27)</li>
-  <li><a href="/fr/docs/Web/API">Référence des API Web</a> : Les interfaces des groupes suivants sont de niveau 1 (voir la section <a href="#tier_1_webapis">API Web de niveau 1</a> ci-dessous pour un éventail plus large de ce que cela inclut (1189) :
-    <ul>
-      <li>Canvas API (112)</li>
-      <li>Clipboard API (13)</li>
-      <li>DOM (439)</li>
-      <li>DOM Events (22)</li>
-      <li>Fetch API (47)</li>
-      <li>File API (48)</li>
-      <li>HTML DOM (371)</li>
-      <li>URL API (43)</li>
-      <li>Web Storage API (8)</li>
-      <li>WebSockets API (28)</li>
-      <li>XMLHttpRequest (58)</li>
-    </ul>
-  </li>
-  <li><a href="/fr/docs/Web/Manifest">Manifestes des applications web</a> (19)</li>
-  <li><a href="/fr/docs/WebAssembly">WebAssembly</a> (12)</li>
-  <li><a href="/fr/docs/Web/Web_Components">Composants web</a> (5)</li>
-</ul>
-
-<p><strong>Total des pages pour le niveau 1 : 4150</strong></p>
-
-<h2 id="tier_2">Niveau 2</h2>
-
-<p>Le contenu de niveau 2 est moins couramment utilisé, mais néanmoins utile.</p>
-
-<ul>
-  <li><a href="/fr/docs/Web/Houdini">CSS Houdini</a> (1)</li>
-  <li><a href="/fr/docs/Games">Développement de jeux vidéo</a> (73)</li>
-  <li><a href="/fr/docs/Web/Guide">Guides pour les développeurs du Web</a> (56)</li>
-  <li><a href="/fr/docs/Web/MathML">MathML</a> (38)</li>
-  <li><a href="/fr/docs/MDN">Le projet MDN</a> (82). C'est important, mais les corrections seront principalement traitées par l'équipe principale du MDN).</li>
-  <li><a href="/fr/docs/Web/SVG">SVG</a> (382)</li>
-  <li><a href="/fr/docs/Glossary">Le glossaire</a> (534)</li>
-  <li><a href="/fr/docs/Web/API">Référence des API Web</a> pour celles qui ne figurent pas parmi celles de niveau 1. (4701)</li>
-  <li><a href="/fr/docs/Mozilla/Add-ons/WebExtensions">WebExtensions</a> (635). Pas vraiment un sujet en lien direct avec la plateforme web, mais quand même important.</li>
-</ul>
-
-<p><strong>Total des pages pour le niveau 2 : 6502</strong></p>
-
-<h2 id="other_content">Autres contenus</h2>
-
-<p>Il existe d'autres contenus sur MDN qui ne concernent pas la plateforme web (comme les contenus archivés, les documents spécifiques à Firefox sur les outils de développement ou les détails internes pour ce navigateur). Ce contenu a été complètement déprogrammé et, dans la plupart des cas, nous essayons de lui trouver une nouvelle place ou de le supprimer s'il n'est plus utile. Nous ne recommandons pas à notre communauté de consacrer du temps à des domaines qui ne sont pas explicitement répertoriés sur cette page.</p>
-
-<h2 id="tier_1_webapis">API Web niveau 1</h2>
-
-<p>Les documents de référence pour les interfaces des API qui suivent (et leurs pages enfant) sont actuellement considérés comme étant de niveau 1. Pour plus d'informations sur la justification de ces regroupements et priorités, voir le travail effectué dans <a href="https://github.com/mdn/sprints/issues/3327">https://github.com/mdn/sprints/issues/3327</a>.</p>
-
-<h3 id="canvas_api">Canvas API (112)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/CanvasGradient">CanvasGradient</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/CanvasImageSource">CanvasImageSource</a></code> (1)</li>
-  <li><code><a href="/fr/docs/Web/API/CanvasPattern">CanvasPattern</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/CanvasRenderingContext2D">CanvasRenderingContext2D</a></code> (71)</li>
-  <li><code><a href="/fr/docs/Web/API/ImageBitmap">ImageBitmap</a></code> (4)</li>
-  <li><code><a href="/fr/docs/Web/API/ImageBitmapRenderingContext">ImageBitmapRenderingContext</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/ImageData">ImageData</a></code> (5)</li>
-  <li><code><a href="/fr/docs/Web/API/OffscreenCanvas">OffscreenCanvas</a></code> (8)</li>
-  <li><code><a href="/fr/docs/Web/API/Path2D">Path2D</a></code> (3)</li>
-  <li><code><a href="/fr/docs/Web/API/RenderingContext">RenderingContext</a></code> (1)</li>
-  <li><code><a href="/fr/docs/Web/API/TextMetrics">TextMetrics</a></code> (13)</li>
-</ul>
-
-<h3 id="clipboard_api">Clipboard API (13)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/Clipboard">Clipboard</a></code> (5)</li>
-  <li><code><a href="/fr/docs/Web/API/ClipboardEvent">ClipboardEvent</a></code> (3)</li>
-  <li><code><a href="/fr/docs/Web/API/ClipboardItem">ClipboardItem</a></code> (5)</li>
-</ul>
-
-<h3 id="dom">DOM (439)</h3>
-
-<div class="note">
-  <p><strong>Note :</strong> « DOM » n'est qu'un groupe partiel - nous n'avons inclus que les documents relatifs à l'interface ayant le plus grand nombre de pages vues, afin de maintenir la taille du niveau 1 à un nombre gérable. Les autres interfaces DOM qui ne figurent pas dans cette liste sont dans le niveau 2.</p>
-</div>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/AbortController">AbortController</a></code> (4)</li>
-  <li><code><a href="/fr/docs/Web/API/ChildNode">ChildNode</a></code> (5)</li>
-  <li><code><a href="/fr/docs/Web/API/CustomEvent">CustomEvent</a></code> (4)</li>
-  <li><code><a href="/fr/docs/Web/API/Document">Document</a></code> (164)</li>
-  <li><code><a href="/fr/docs/Web/API/DOMParser">DOMParser</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/DOMString">DOMString</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/Element">Element</a></code> (176)</li>
-  <li><code><a href="/fr/docs/Web/API/Event">Event</a></code> (24)</li>
-  <li><code><a href="/fr/docs/Web/API/EventTarget">EventTarget</a></code> (5)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLCollection">HTMLCollection</a></code> (4)</li>
-  <li><code><a href="/fr/docs/Web/API/MutationObserver">MutationObserver</a></code> (5)</li>
-  <li><code><a href="/fr/docs/Web/API/Node">Node</a></code> (36)</li>
-  <li><code><a href="/fr/docs/Web/API/NodeList">NodeList</a></code> (7)</li>
-  <li><code><a href="/fr/docs/Web/API/USVString">USVString</a></code> (1)</li>
-</ul>
-
-<h3 id="dom_events">DOM Events (22)</h3>
-
-<div class="note notecard">
-  <p><strong>Note :</strong> « DOM Events » n'est qu'un groupe partiel - nous n'avons inclus que les documents relatifs à l'interface ayant le plus grand nombre de pages vues, afin de maintenir la taille du niveau 1 à un nombre raisonnable. Les autres interfaces DOM Events qui ne figurent pas dans cette liste se trouvent au niveau 2.</p>
-</div>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/EventListener">EventListener</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/KeyboardEvent">KeyboardEvent</a></code> (20)</li>
-</ul>
-
-<h3 id="fetch_api">Fetch API (47)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/Body">Body</a></code> (8)</li>
-  <li><code><a href="/fr/docs/Web/API/Headers">Headers</a></code> (11)</li>
-  <li><code><a href="/fr/docs/Web/API/Request">Request</a></code> (15)</li>
-  <li><code><a href="/fr/docs/Web/API/Response">Response</a></code> (13)</li>
-</ul>
-
-<h3 id="file_api">File API (48)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/Blob">Blob</a></code> (8)</li>
-  <li><code><a href="/fr/docs/Web/API/File">File</a></code> (15)</li>
-  <li><code><a href="/fr/docs/Web/API/FileList">FileList</a></code> (1)</li>
-  <li><code><a href="/fr/docs/Web/API/FileReader">FileReader</a></code> (19)</li>
-  <li><code><a href="/fr/docs/Web/API/FileReaderSync">FileReaderSync</a></code> (5)</li>
-</ul>
-
-<h3 id="html_dom">HTML DOM (371)</h3>
-
-<div class="note notecard">
-  <p><strong>Note :</strong> « HTML DOM » n'est qu'un groupe partiel - nous n'avons inclus que les documents de l'interface ayant le plus grand nombre de pages vues, afin de maintenir la taille du niveau 1 à un nombre gérable. Les autres interfaces HTML DOM qui ne figurent pas dans cette liste sont dans le niveau 2.</p>
-</div>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/History">History</a></code> (9)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLAudioElement">HTMLAudioElement</a></code> (4)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLCanvasElement">HTMLCanvasElement</a></code> (14)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLElement">HTMLElement</a></code> (45)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLFormElement">HTMLFormElement</a></code> (17)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLInputElement">HTMLInputElement</a></code> (17)</li>
-  <li><code><a href="/fr/docs/Web/API/HTMLTextAreaElement">HTMLTextAreaElement</a></code> (2)</li>
-  <li><code><a href="/fr/docs/Web/API/Location">Location</a></code> (17)</li>
-  <li><code><a href="/fr/docs/Web/API/Navigator">Navigator</a></code> (45)</li>
-  <li><code><a href="/fr/docs/Web/API/NavigatorLanguage">NavigatorLanguage</a></code> (3)</li>
-  <li><code><a href="/fr/docs/Web/API/NavigatorOnLine">NavigatorOnLine</a></code> (3)</li>
-  <li><code><a href="/fr/docs/Web/API/Window">Window</a></code> (182)</li>
-  <li><code><a href="/fr/docs/Web/API/WindowEventHandlers">WindowEventHandlers</a></code> (13)</li>
-</ul>
-
-<h3 id="url_api">URL API (43)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/URL">URL</a></code> (18)</li>
-  <li><code><a href="/fr/docs/Web/API/URLSearchParams">URLSearchParams</a></code> (14)</li>
-  <li><code><a href="/fr/docs/Web/API/URLUtilsReadOnly">URLUtilsReadOnly</a></code> (11)</li>
-</ul>
-
-<h3 id="web_storage_api">Web Storage API (8)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/Storage">Storage</a></code> (7)</li>
-  <li><code><a href="/fr/docs/Web/API/StorageEvent">StorageEvent</a></code> (1)</li>
-</ul>
-
-<h3 id="websockets_api">WebSockets API (28)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/CloseEvent">CloseEvent</a></code> (3)</li>
-  <li><code><a href="/fr/docs/Web/API/MessageEvent">MessageEvent</a></code> (7)</li>
-  <li><code><a href="/fr/docs/Web/API/WebSocket">WebSocket</a></code> (18)</li>
-</ul>
-
-<h3 id="xmlhttprequest">XMLHttpRequest (58)</h3>
-
-<ul>
-  <li><code><a href="/fr/docs/Web/API/FormData">FormData</a></code> (12)</li>
-  <li><code><a href="/fr/docs/Web/API/XMLHttpRequest">XMLHttpRequest</a></code> (40)</li>
-  <li><code><a href="/fr/docs/Web/API/XMLHttpRequestEventTarget">XMLHttpRequestEventTarget</a></code> (6)</li>
-</ul>
+{{MDNSidebar}}
+
+Ce document définit les différents niveaux de priorité sur MDN, et indique quels sujets de documentation existent dans chaque niveau - nous les catégorisons entre **Niveau 1** et **Niveau 2**.
+
+L'objectif de ce document est double :
+
+- Aider à appliquer des mesures de priorité aux bogues de contenu pendant notre processus de triage, ce qui aide les contributeurs à prendre une décision sur les bogues sur lesquels travailler en découvrant ceux qui sont les plus importants pour le moment.
+- Aider les contributeurs qui souhaitent travailler sur un sujet spécifique (plutôt que sur un bogue particulier) à décider du sujet où il serait le plus utile de consacrer du temps (par exemple, pour les personnes qui aiment exécuter des scripts de nettoyage automatique sur MDN).
+
+L'importance relative de ces documents a été déterminée uniquement en fonction du nombre de pages vues. Il y a beaucoup de mesures que nous aurions pu utiliser, mais le nombre de pages vues est objectif et reste un bon indicateur. Les technologies web les plus importantes sont consultées plus souvent et, par conséquent, la résolution des problèmes liés à ces documents semble la plus importante.
+
+Gardez également à l'esprit que ces niveaux sont constitués d'arborescences de documents isolés (c'est-à-dire la page liée, plus tous les documents de la hiérarchie qui lui sont inférieurs). Il arrive qu'un document de niveau 1 soit lié à un document de niveau 2, ou vice versa, et c'est normal.
+
+Les chiffres entre parenthèses après chaque arbre de documents représentent le nombre de documents sous cet arbre pour l'anglais. Ces chiffres sont susceptibles de changer au fil du temps, et il faudra peut-être les revoir avant longtemps.
+
+## Niveau 1
+
+Le contenu de niveau 1 est le plus important sur MDN : il compte le plus grand nombre de lectrices et lecteurs. Il est censé couvrir les technologies les plus importantes pour la plateforme web.
+
+- [Accessibilité](/fr/docs/Web/Accessibility) (104)
+- [CSS : Feuilles de style en cascade](/fr/docs/Web/CSS) (933)
+- [Événements](/fr/docs/Web/Events) (4)
+- [HTML : HyperText Markup Language](/fr/docs/Web/HTML) (239)
+- [HTTP](/fr/docs/Web/HTTP) (292)
+- [JavaScript](/fr/docs/Web/JavaScript) (921)
+- [Apprendre le développement web](/fr/docs/Learn) (355)
+- [Médias sur le Web](/fr/docs/Web/Media) (17)
+- [Performance](/fr/docs/Web/Performance) (16)
+- [Vie privée](/fr/docs/Web/Privacy) (1)
+- [Applications web progressives](/fr/docs/Web/Progressive_web_apps) (16)
+- [Sécurité](/fr/docs/Web/Security) (27)
+- [Référence des API Web](/fr/docs/Web/API) : Les interfaces des groupes suivants sont de niveau 1 (voir la section [API Web de niveau 1](#tier_1_webapis) ci-dessous pour un éventail plus large de ce que cela inclut (1189) :
+
+  - Canvas API (112)
+  - Clipboard API (13)
+  - DOM (439)
+  - DOM Events (22)
+  - Fetch API (47)
+  - File API (48)
+  - HTML DOM (371)
+  - URL API (43)
+  - Web Storage API (8)
+  - WebSockets API (28)
+  - XMLHttpRequest (58)
+
+- [Manifestes des applications web](/fr/docs/Web/Manifest) (19)
+- [WebAssembly](/fr/docs/WebAssembly) (12)
+- [Composants web](/fr/docs/Web/Web_Components) (5)
+
+**Total des pages pour le niveau 1 : 4150**
+
+## Niveau 2
+
+Le contenu de niveau 2 est moins couramment utilisé, mais néanmoins utile.
+
+- [CSS Houdini](/fr/docs/Web/Houdini) (1)
+- [Développement de jeux vidéo](/fr/docs/Games) (73)
+- [Guides pour les développeurs du Web](/fr/docs/Web/Guide) (56)
+- [MathML](/fr/docs/Web/MathML) (38)
+- [Le projet MDN](/fr/docs/MDN) (82). C'est important, mais les corrections seront principalement traitées par l'équipe principale du MDN).
+- [SVG](/fr/docs/Web/SVG) (382)
+- [Le glossaire](/fr/docs/Glossary) (534)
+- [Référence des API Web](/fr/docs/Web/API) pour celles qui ne figurent pas parmi celles de niveau 1. (4701)
+- [WebExtensions](/fr/docs/Mozilla/Add-ons/WebExtensions) (635). Pas vraiment un sujet en lien direct avec la plateforme web, mais quand même important.
+
+**Total des pages pour le niveau 2 : 6502**
+
+## Autres contenus
+
+Il existe d'autres contenus sur MDN qui ne concernent pas la plateforme web (comme les contenus archivés, les documents spécifiques à Firefox sur les outils de développement ou les détails internes pour ce navigateur). Ce contenu a été complètement déprogrammé et, dans la plupart des cas, nous essayons de lui trouver une nouvelle place ou de le supprimer s'il n'est plus utile. Nous ne recommandons pas à notre communauté de consacrer du temps à des domaines qui ne sont pas explicitement répertoriés sur cette page.
+
+## API Web niveau 1
+
+Les documents de référence pour les interfaces des API qui suivent (et leurs pages enfant) sont actuellement considérés comme étant de niveau 1. Pour plus d'informations sur la justification de ces regroupements et priorités, voir le travail effectué dans <https://github.com/mdn/sprints/issues/3327>.
+
+### Canvas API (112)
+
+- [`CanvasGradient`](/fr/docs/Web/API/CanvasGradient) (2)
+- [`CanvasImageSource`](/fr/docs/Web/API/CanvasImageSource) (1)
+- [`CanvasPattern`](/fr/docs/Web/API/CanvasPattern) (2)
+- [`CanvasRenderingContext2D`](/fr/docs/Web/API/CanvasRenderingContext2D) (71)
+- [`ImageBitmap`](/fr/docs/Web/API/ImageBitmap) (4)
+- [`ImageBitmapRenderingContext`](/fr/docs/Web/API/ImageBitmapRenderingContext) (2)
+- [`ImageData`](/fr/docs/Web/API/ImageData) (5)
+- [`OffscreenCanvas`](/fr/docs/Web/API/OffscreenCanvas) (8)
+- [`Path2D`](/fr/docs/Web/API/Path2D) (3)
+- [`RenderingContext`](/fr/docs/Web/API/RenderingContext) (1)
+- [`TextMetrics`](/fr/docs/Web/API/TextMetrics) (13)
+
+### Clipboard API (13)
+
+- [`Clipboard`](/fr/docs/Web/API/Clipboard) (5)
+- [`ClipboardEvent`](/fr/docs/Web/API/ClipboardEvent) (3)
+- [`ClipboardItem`](/fr/docs/Web/API/ClipboardItem) (5)
+
+### DOM (439)
+
+> **Note :** « DOM » n'est qu'un groupe partiel - nous n'avons inclus que les documents relatifs à l'interface ayant le plus grand nombre de pages vues, afin de maintenir la taille du niveau 1 à un nombre gérable. Les autres interfaces DOM qui ne figurent pas dans cette liste sont dans le niveau 2.
+
+- [`AbortController`](/fr/docs/Web/API/AbortController) (4)
+- [`ChildNode`](/fr/docs/Web/API/ChildNode) (5)
+- [`CustomEvent`](/fr/docs/Web/API/CustomEvent) (4)
+- [`Document`](/fr/docs/Web/API/Document) (164)
+- [`DOMParser`](/fr/docs/Web/API/DOMParser) (2)
+- [`DOMString`](/fr/docs/Web/API/DOMString) (2)
+- [`Element`](/fr/docs/Web/API/Element) (176)
+- [`Event`](/fr/docs/Web/API/Event) (24)
+- [`EventTarget`](/fr/docs/Web/API/EventTarget) (5)
+- [`HTMLCollection`](/fr/docs/Web/API/HTMLCollection) (4)
+- [`MutationObserver`](/fr/docs/Web/API/MutationObserver) (5)
+- [`Node`](/fr/docs/Web/API/Node) (36)
+- [`NodeList`](/fr/docs/Web/API/NodeList) (7)
+- [`USVString`](/fr/docs/Web/API/USVString) (1)
+
+### DOM Events (22)
+
+> **Note :** « DOM Events » n'est qu'un groupe partiel - nous n'avons inclus que les documents relatifs à l'interface ayant le plus grand nombre de pages vues, afin de maintenir la taille du niveau 1 à un nombre raisonnable. Les autres interfaces DOM Events qui ne figurent pas dans cette liste se trouvent au niveau 2.
+
+- [`EventListener`](/fr/docs/Web/API/EventListener) (2)
+- [`KeyboardEvent`](/fr/docs/Web/API/KeyboardEvent) (20)
+
+### Fetch API (47)
+
+- [`Body`](/fr/docs/Web/API/Body) (8)
+- [`Headers`](/fr/docs/Web/API/Headers) (11)
+- [`Request`](/fr/docs/Web/API/Request) (15)
+- [`Response`](/fr/docs/Web/API/Response) (13)
+
+### File API (48)
+
+- [`Blob`](/fr/docs/Web/API/Blob) (8)
+- [`File`](/fr/docs/Web/API/File) (15)
+- [`FileList`](/fr/docs/Web/API/FileList) (1)
+- [`FileReader`](/fr/docs/Web/API/FileReader) (19)
+- [`FileReaderSync`](/fr/docs/Web/API/FileReaderSync) (5)
+
+### HTML DOM (371)
+
+> **Note :** « HTML DOM » n'est qu'un groupe partiel - nous n'avons inclus que les documents de l'interface ayant le plus grand nombre de pages vues, afin de maintenir la taille du niveau 1 à un nombre gérable. Les autres interfaces HTML DOM qui ne figurent pas dans cette liste sont dans le niveau 2.
+
+- [`History`](/fr/docs/Web/API/History) (9)
+- [`HTMLAudioElement`](/fr/docs/Web/API/HTMLAudioElement) (4)
+- [`HTMLCanvasElement`](/fr/docs/Web/API/HTMLCanvasElement) (14)
+- [`HTMLElement`](/fr/docs/Web/API/HTMLElement) (45)
+- [`HTMLFormElement`](/fr/docs/Web/API/HTMLFormElement) (17)
+- [`HTMLInputElement`](/fr/docs/Web/API/HTMLInputElement) (17)
+- [`HTMLTextAreaElement`](/fr/docs/Web/API/HTMLTextAreaElement) (2)
+- [`Location`](/fr/docs/Web/API/Location) (17)
+- [`Navigator`](/fr/docs/Web/API/Navigator) (45)
+- [`NavigatorLanguage`](/fr/docs/Web/API/NavigatorLanguage) (3)
+- [`NavigatorOnLine`](/fr/docs/Web/API/NavigatorOnLine) (3)
+- [`Window`](/fr/docs/Web/API/Window) (182)
+- [`WindowEventHandlers`](/fr/docs/Web/API/WindowEventHandlers) (13)
+
+### URL API (43)
+
+- [`URL`](/fr/docs/Web/API/URL) (18)
+- [`URLSearchParams`](/fr/docs/Web/API/URLSearchParams) (14)
+- [`URLUtilsReadOnly`](/fr/docs/Web/API/URLUtilsReadOnly) (11)
+
+### Web Storage API (8)
+
+- [`Storage`](/fr/docs/Web/API/Storage) (7)
+- [`StorageEvent`](/fr/docs/Web/API/StorageEvent) (1)
+
+### WebSockets API (28)
+
+- [`CloseEvent`](/fr/docs/Web/API/CloseEvent) (3)
+- [`MessageEvent`](/fr/docs/Web/API/MessageEvent) (7)
+- [`WebSocket`](/fr/docs/Web/API/WebSocket) (18)
+
+### XMLHttpRequest (58)
+
+- [`FormData`](/fr/docs/Web/API/FormData) (12)
+- [`XMLHttpRequest`](/fr/docs/Web/API/XMLHttpRequest) (40)
+- [`XMLHttpRequestEventTarget`](/fr/docs/Web/API/XMLHttpRequestEventTarget) (6)
diff --git a/files/fr/mdn/contribute/feedback/index.md b/files/fr/mdn/contribute/feedback/index.md
index 29c900a3c5..014ab9f8e7 100644
--- a/files/fr/mdn/contribute/feedback/index.md
+++ b/files/fr/mdn/contribute/feedback/index.md
@@ -8,60 +8,54 @@ tags:
   - MDN Meta
 translation_of: MDN/Contribute/Feedback
 ---
-<div>{{MDNSidebar}}</div>
+{{MDNSidebar}}
 
-<p>Bienvenue sur MDN Web Docs ! Si vous avez des suggestions ou avez des problèmes avec MDN, vous êtes au bon endroit. Nous vous remercions par avance de l'intérêt que vous nous portez.</p>
+Bienvenue sur MDN Web Docs ! Si vous avez des suggestions ou avez des problèmes avec MDN, vous êtes au bon endroit. Nous vous remercions par avance de l'intérêt que vous nous portez.
 
-<p>Il y existe plusieurs façons pour porter votre voix, cet article vous les explique.</p>
+Il y existe plusieurs façons pour porter votre voix, cet article vous les explique.
 
-<h2 id="update_the_documentation">Mettre à jour la documentation</h2>
+## Mettre à jour la documentation
 
-<p>Tout d'abord, si vous avez constaté un problème dans la documentation, sentez vous libre de le corriger vous-même. Commencez par lire les <a href="https://github.com/mdn/content/#making-contributions">étapes spécifiques pour se préparer à faire des contributions</a>.</p>
+Tout d'abord, si vous avez constaté un problème dans la documentation, sentez vous libre de le corriger vous-même. Commencez par lire les [étapes spécifiques pour se préparer à faire des contributions](https://github.com/mdn/content/#making-contributions).
 
-<p>Si vous souhaitez savoir comment contribuer aux traductions en français, vous pouvez également lire <a href="https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer">ce billet</a>.</p>
+Si vous souhaitez savoir comment contribuer aux traductions en français, vous pouvez également lire [ce billet](https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer).
 
-<p>Les sources de la documentation ici sont <a href="https://github.com/mdn/translated-content/">stockées dans GitHub</a>, et gérées par une équipe de bénévoles et de salariés, alors ne soyez pas timide - votre grammaire n'a pas besoin d'être parfaite. Nous passerons en revue vos modifications et vous aiderons à corriger les erreurs éventuelles.</p>
+Les sources de la documentation ici sont [stockées dans GitHub](https://github.com/mdn/translated-content/), et gérées par une équipe de bénévoles et de salariés, alors ne soyez pas timide - votre grammaire n'a pas besoin d'être parfaite. Nous passerons en revue vos modifications et vous aiderons à corriger les erreurs éventuelles.
 
-<p>Pour plus d'information sur comment contribuer à la documentation :</p>
+Pour plus d'information sur comment contribuer à la documentation :
 
-<ul>
- <li><a href="/fr/docs/MDN/Contribute/Getting_started">Débuter sur MDN</a></li>
- <li><a href="/fr/docs/MDN/Contribute">Contribuer à MDN</a></li>
-</ul>
+- [Débuter sur MDN](/fr/docs/MDN/Contribute/Getting_started)
+- [Contribuer à MDN](/fr/docs/MDN/Contribute)
 
-<h2 id="rejoignez_la_conversation">Rejoignez la conversation</h2>
+## Rejoignez la conversation
 
-<p>Venez nous parler ! Il y a plusieurs méthodes pour rentrer en contact avec les personnes qui travaillent sur le contenu de MDN.</p>
+Venez nous parler ! Il y a plusieurs méthodes pour rentrer en contact avec les personnes qui travaillent sur le contenu de MDN.
 
-<h3 id="chat">Discussions en direct - chats</h3>
+### Discussions en direct - chats
 
-<p>Nous utilisons <a href="https://wiki.mozilla.org/Matrix">Matrix</a> pour converser sur MDN et son contenu. Vous pouvez participer à la conversation !</p>
+Nous utilisons [Matrix](https://wiki.mozilla.org/Matrix) pour converser sur MDN et son contenu. Vous pouvez participer à la conversation !
 
-<dl>
-  <dt><a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">MDN Web Docs</a></dt>
-  <dd>Sur ce salon sont regroupés les membres de la communauté internationale de MDN, il est destiné aux discussions générales sur MDN : utilisation du site, lecture du contenu du site et contribution au contenu du site. Si vous avez des questions ou des commentaires sur le contenu des articles, sur les nouveaux articles que vous aimeriez voir ou créer, ou si vous voulez simplement parler avec l'équipe de rédaction, c'est l'endroit idéal. Il s'agit d'un canal anglophone, toutefois, des personnes francophones s'y trouvent généralement.</dd>
-  <dt><a href="https://chat.mozilla.org/#/room/#l10n-fr:mozilla.org">Localisation / traduction en français</a></dt>
-  <dd>Sur ce salon sont regroupés les membres de la communauté francophone de Mozilla (que ce soit pour Firefox, MDN ou d'autres sites ou outils).</dd>
-</dl>
+- [MDN Web Docs](https://chat.mozilla.org/#/room/#mdn:mozilla.org)
+  - : Sur ce salon sont regroupés les membres de la communauté internationale de MDN, il est destiné aux discussions générales sur MDN : utilisation du site, lecture du contenu du site et contribution au contenu du site. Si vous avez des questions ou des commentaires sur le contenu des articles, sur les nouveaux articles que vous aimeriez voir ou créer, ou si vous voulez simplement parler avec l'équipe de rédaction, c'est l'endroit idéal. Il s'agit d'un canal anglophone, toutefois, des personnes francophones s'y trouvent généralement.
+- [Localisation / traduction en français](https://chat.mozilla.org/#/room/#l10n-fr:mozilla.org)
+  - : Sur ce salon sont regroupés les membres de la communauté francophone de Mozilla (que ce soit pour Firefox, MDN ou d'autres sites ou outils).
 
-<h3 id="asynchronous_discussions">Discussions (asynchrones)</h3>
+### Discussions (asynchrones)
 
-<p>Les discussions plus importantes et qui ne nécessitent pas d'être connecté à tout moment se déroulent sur <a href="https://discourse.mozilla-community.org/c/mdn">le forum Discourse</a>. Vous pouvez envoyer des messages sur ce forum par e-mail en utilisant l'adresse <a href="mailto://mdn@mozilla-community.org">mdn@mozilla-community.org</a>. Si vous vous inscrivez sur le forum, vous pouvez également choisir de recevoir des notifications par e-mail à propos des discussions.</p>
+Les discussions plus importantes et qui ne nécessitent pas d'être connecté à tout moment se déroulent sur [le forum Discourse](https://discourse.mozilla-community.org/c/mdn). Vous pouvez envoyer des messages sur ce forum par e-mail en utilisant l'adresse [mdn@mozilla-community.org](mailto://mdn@mozilla-community.org). Si vous vous inscrivez sur le forum, vous pouvez également choisir de recevoir des notifications par e-mail à propos des discussions.
 
-<h2 id="report_an_issue">Signaler un problème</h2>
+## Signaler un problème
 
-<h3 id="documentation_issues">Problèmes dans la documentation</h3>
+### Problèmes dans la documentation
 
-<p>Si vous voyez un problème avec la documentation et que vous ne pouvez pas la corriger vous-même pour une quelconque raison, vous pouvez <a href="https://github.com/mdn/translated-content/issues/new" title="Signaler un problème de contenu de la documentation.">signaler un problème</a>. Vous pouvez utiliser ce formulaire pour tout problème avec la documentation, pas exemple :</p>
+Si vous voyez un problème avec la documentation et que vous ne pouvez pas la corriger vous-même pour une quelconque raison, vous pouvez [signaler un problème](https://github.com/mdn/translated-content/issues/new "Signaler un problème de contenu de la documentation."). Vous pouvez utiliser ce formulaire pour tout problème avec la documentation, pas exemple :
 
-<ul>
-  <li>une simple correction</li>
-  <li>une demande de contenu entièrement nouveau</li>
-  <li>signaler les contenus inappropriés (y compris le spam et les traductions mal placées)</li>
-</ul>
+- une simple correction
+- une demande de contenu entièrement nouveau
+- signaler les contenus inappropriés (y compris le spam et les traductions mal placées)
 
-<p>Comme évoqué plus haut, n'hésitez pas à contribuer vous-même pour corriger ces erreurs.</p>
+Comme évoqué plus haut, n'hésitez pas à contribuer vous-même pour corriger ces erreurs.
 
-<h3 id="site_issues">Problèmes sur le site</h3>
+### Problèmes sur le site
 
-<p>Si vous rencontrez un problème avec le site ou avez de nouvelles idées pour celui-ci, vous pouvez <a href="hhttps://github.com/mdn/yari/issues">créer un ticket à l'équipe de développement de MDN</a>.</p>
+Si vous rencontrez un problème avec le site ou avez de nouvelles idées pour celui-ci, vous pouvez [créer un ticket à l'équipe de développement de MDN](hhttps://github.com/mdn/yari/issues).
diff --git a/files/fr/mdn/contribute/getting_started/index.md b/files/fr/mdn/contribute/getting_started/index.md
index 563a36e2d7..9ecf83d0cc 100644
--- a/files/fr/mdn/contribute/getting_started/index.md
+++ b/files/fr/mdn/contribute/getting_started/index.md
@@ -10,50 +10,45 @@ tags:
   - New Contributors
 translation_of: MDN/Contribute/Getting_started
 ---
-<div>{{MDNSidebar}}</div>
+{{MDNSidebar}}
 
-<p>Nous sommes une communauté ouverte de développeuses et développeurs qui créent des ressources pour un meilleur Web, quelle que soit la marque, le navigateur ou la plate-forme. Tout le monde peut contribuer et chaque personne qui le fait nous rend plus forts. Ensemble, nous pouvons continuer à stimuler l'innovation sur le Web pour servir le bien commun. Cela commence ici, avec vous.</p>
+Nous sommes une communauté ouverte de développeuses et développeurs qui créent des ressources pour un meilleur Web, quelle que soit la marque, le navigateur ou la plate-forme. Tout le monde peut contribuer et chaque personne qui le fait nous rend plus forts. Ensemble, nous pouvons continuer à stimuler l'innovation sur le Web pour servir le bien commun. Cela commence ici, avec vous.
 
-<p>Chaque partie de MDN (documents, démos et le site lui-même) est créée par une communauté ouverte de développeuses et développeurs. Rejoignez-nous !</p>
+Chaque partie de MDN (documents, démos et le site lui-même) est créée par une communauté ouverte de développeuses et développeurs. Rejoignez-nous !
 
-<h2 id="4_simple_steps_to_MDN">4 étapes simples vers MDN</h2>
+## 4 étapes simples vers MDN
 
-<p>MDN est une ressource open source où <strong>toute personne</strong> peut ajouter et modifier des contenus. Il n'est pas nécessaire d'être un programmeur ou d'en savoir beaucoup sur les technologies. Il y a beaucoup de choses à faire, des plus simples (relecture et correction de fautes de frappe) aux plus complexes (rédaction de la documentation des API).</p>
+MDN est une ressource open source où **toute personne** peut ajouter et modifier des contenus. Il n'est pas nécessaire d'être un programmeur ou d'en savoir beaucoup sur les technologies. Il y a beaucoup de choses à faire, des plus simples (relecture et correction de fautes de frappe) aux plus complexes (rédaction de la documentation des API).
 
-<p>Contribuer est facile et sûr. Même si vous faites une erreur, elle est facilement corrigée. Même si vous ne savez pas exactement comment les choses doivent être présentées, ou si votre grammaire n'est pas très bonne, ne vous inquiétez pas ! Nous avons une équipe de personnes dont le travail consiste à s'assurer que le contenu de MDN est aussi bon que possible. Quelqu'un sera là pour s'assurer que votre travail est soigné et bien écrit. Partagez ce que vous savez et suivez vos points forts.</p>
+Contribuer est facile et sûr. Même si vous faites une erreur, elle est facilement corrigée. Même si vous ne savez pas exactement comment les choses doivent être présentées, ou si votre grammaire n'est pas très bonne, ne vous inquiétez pas ! Nous avons une équipe de personnes dont le travail consiste à s'assurer que le contenu de MDN est aussi bon que possible. Quelqu'un sera là pour s'assurer que votre travail est soigné et bien écrit. Partagez ce que vous savez et suivez vos points forts.
 
-<h3>Étape 1 : Créer un compte GitHub</h3>
+### Étape 1 : Créer un compte GitHub
 
-<p>Pour commencer vos contributions à MDN, vous devez <a href="https://github.com/mdn/content/#setup">créer un compte GitHub</a>.</p>
+Pour commencer vos contributions à MDN, vous devez [créer un compte GitHub](https://github.com/mdn/content/#setup).
 
+### Étape 2 : Choisir une tâche à accomplir
 
-<h3 id="Step_2_Pick_a_task_to_complete">Étape 2 : Choisir une tâche à accomplir</h3>
+Maintenant que vous êtes connecté, lisez les descriptions des différents types de tâches disponibles sur la [page relative aux contributions](/fr/docs/MDN/Contribute), et décidez de celle qui vous attire le plus. Vous pouvez choisir la tâche qui vous convient et commencer à contribuer.
 
-<p>Maintenant que vous êtes connecté, lisez les descriptions des différents types de tâches disponibles sur la <a href="/fr/docs/MDN/Contribute">page relative aux contributions</a>, et décidez de celle qui vous attire le plus. Vous pouvez choisir la tâche qui vous convient et commencer à contribuer.</p>
+### Étape 3 : Effectuer la tâche
 
-<h3 id="Step_3_Do_the_task">Étape 3 : Effectuer la tâche</h3>
+Une fois que vous avez décidé du type de tâche que vous voulez accomplir, trouvez une page spécifique, un exemple de code, etc. sur lequel travailler, et faites-le !
 
-<p>Une fois que vous avez décidé du type de tâche que vous voulez accomplir, trouvez une page spécifique, un exemple de code, etc. sur lequel travailler, et faites-le !</p>
+### Étape 4 : Demander de l'aide
 
-<h3 id="Step_4_Ask_for_help">Étape 4 : Demander de l'aide</h3>
+Si vous n'êtes pas sûr de ce que vous devez faire à un moment donné, vous pouvez demander de l'aide. Il existe plusieurs options d'aide :
 
-<p>Si vous n'êtes pas sûr de ce que vous devez faire à un moment donné, vous pouvez demander de l'aide. Il existe plusieurs options d'aide :</p>
+- Si vous voulez nous parler de manière synchrone et poser des questions sur MDN lui-même, rejoignez la discussion sur le salon de discussion [Localisation / traduction en français](https://chat.mozilla.org/#/room/#l10n-fr:mozilla.org) sur [Matrix](https://wiki.mozilla.org/Matrix).
+- Vous pouvez également nous envoyer un e-mail à <mdn-admins@mozilla.org>.
+- Si vous apprenez le développement web et êtes bloqué sur un problème de codage, nous avons des [forums actifs](https://discourse.mozilla.org/c/mdn/learn/250) où vous pouvez poser des questions et obtenir de l'aide.
 
-<ul>
-  <li>Si vous voulez nous parler de manière synchrone et poser des questions sur MDN lui-même, rejoignez la discussion sur le salon de discussion <a href="https://chat.mozilla.org/#/room/#l10n-fr:mozilla.org">Localisation / traduction en français</a> sur <a href="https://wiki.mozilla.org/Matrix">Matrix</a>.</li>
-  <li>Vous pouvez également nous envoyer un e-mail à <a href="mailto:mdn-admins@mozilla.org">mdn-admins@mozilla.org</a>.</li>
-  <li>Si vous apprenez le développement web et êtes bloqué sur un problème de codage, nous avons des <a href="https://discourse.mozilla.org/c/mdn/learn/250">forums actifs</a> où vous pouvez poser des questions et obtenir de l'aide.</li>
-</ul>
+Ne vous souciez pas de le faire parfaitement ; d'autres contributeurs MDN sont là pour aider à corriger les erreurs qui se glissent.
 
-<p>Ne vous souciez pas de le faire parfaitement ; d'autres contributeurs MDN sont là pour aider à corriger les erreurs qui se glissent.</p>
+## Guides complets et utiles pour les débutants
 
-<h2 id="useful_complete_beginners_guides">Guides complets et utiles pour les débutants</h2>
+Nous attendons des contributeurs à MDN qu'ils aient un certain nombre de connaissances préalables avant de commencer à travailler sur le contenu. Si les sujets suivants vous sont inconnus, nous vous conseillons de consulter les liens fournis pour vous aider à vous mettre à niveau :
 
-<p>Nous attendons des contributeurs à MDN qu'ils aient un certain nombre de connaissances préalables avant de commencer à travailler sur le contenu. Si les sujets suivants vous sont inconnus, nous vous conseillons de consulter les liens fournis pour vous aider à vous mettre à niveau :</p>
-
-<ul>
-  <li>Technologies web : Si vous êtes novice en HTML, CSS, JavaScript, etc., consultez nos tutoriels pour <a href="/fr/docs/Learn">Apprendre le développement web</a>.</li>
-  <li>Open source : Si vous n'avez jamais contribué à un projet open source, lisez <a href="/fr/docs/MDN/Contribuer/Open_source_etiquette">L'étiquette de base des projets open source</a>.</li>
-  <li>Git et GitHub : Si vous n'êtes pas familier avec ces outils, <a href="/fr/docs/MDN/Contribute/GitHub_beginners">GitHub pour les grands débutants</a> vous permettra de démarrer. Vous pouvez également consulter <a href="https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer">ce billet sur les contributions à MDN avec Git.</a></li>
-  <li>Les structures de dépôt de MDN : Si vous ne savez pas quels dépôts modifier pour apporter des modifications aux différentes parties du contenu de MDN, <a href="/fr/docs/MDN/Contribute/Where_is_everything">Où se trouve tout sur MDN ?</a> vous orientera vers les bons endroits.</li>
-</ul>
+- Technologies web : Si vous êtes novice en HTML, CSS, JavaScript, etc., consultez nos tutoriels pour [Apprendre le développement web](/fr/docs/Learn).
+- Open source : Si vous n'avez jamais contribué à un projet open source, lisez [L'étiquette de base des projets open source](/fr/docs/MDN/Contribuer/Open_source_etiquette).
+- Git et GitHub : Si vous n'êtes pas familier avec ces outils, [GitHub pour les grands débutants](/fr/docs/MDN/Contribute/GitHub_beginners) vous permettra de démarrer. Vous pouvez également consulter [ce billet sur les contributions à MDN avec Git.](https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer)
+- Les structures de dépôt de MDN : Si vous ne savez pas quels dépôts modifier pour apporter des modifications aux différentes parties du contenu de MDN, [Où se trouve tout sur MDN ?](/fr/docs/MDN/Contribute/Where_is_everything) vous orientera vers les bons endroits.
diff --git a/files/fr/mdn/contribute/github_beginners/index.md b/files/fr/mdn/contribute/github_beginners/index.md
index 96dff3ffa4..28f01d1226 100644
--- a/files/fr/mdn/contribute/github_beginners/index.md
+++ b/files/fr/mdn/contribute/github_beginners/index.md
@@ -9,430 +9,420 @@ tags:
   - Beginners
 translation_of: MDN/Contribute/GitHub_beginners
 ---
-<p>{{MDNSidebar}}</p>
+{{MDNSidebar}}
 
-<p><a href="https://git-scm.com/">Git</a> et <a href="https://github.com/">GitHub</a> sont des outils difficiles à apprendre et à maîtriser, mais avec quelques commandes simples et quelques bons conseils, vous devriez pouvoir en faire assez pour commencer à contribuer à MDN sans trop de difficultés. Le but de cet article n'est pas de vous aider à maîtriser Git ou GitHub, mais de vous donner juste assez d'éléments pour être productif à un niveau de base et contribuer à MDN.</p>
+[Git](https://git-scm.com/) et [GitHub](https://github.com/) sont des outils difficiles à apprendre et à maîtriser, mais avec quelques commandes simples et quelques bons conseils, vous devriez pouvoir en faire assez pour commencer à contribuer à MDN sans trop de difficultés. Le but de cet article n'est pas de vous aider à maîtriser Git ou GitHub, mais de vous donner juste assez d'éléments pour être productif à un niveau de base et contribuer à MDN.
 
-<p>Si vous êtes déjà familiarisé avec les bases de Git/GitHub, vous n'apprendrez probablement rien de nouveau ici, mais cet article peut néanmoins vous être utile comme référence. Il existe également une <a href="/fr/docs/MDN/Contribute/GitHub_cheatsheet">antisèche GitHub</a> disponible, avec juste les commandes et aucune des longues explications.</p>
+Si vous êtes déjà familiarisé avec les bases de Git/GitHub, vous n'apprendrez probablement rien de nouveau ici, mais cet article peut néanmoins vous être utile comme référence. Il existe également une [antisèche GitHub](/fr/docs/MDN/Contribute/GitHub_cheatsheet) disponible, avec juste les commandes et aucune des longues explications.
 
-<h2 id="essential_concepts">Concepts essentiels</h2>
+## Concepts essentiels
 
-<p>Voici les concepts essentiels que vous devez connaître pour tirer le meilleur parti de Git et de GitHub.</p>
+Voici les concepts essentiels que vous devez connaître pour tirer le meilleur parti de Git et de GitHub.
 
-<ul>
-  <li>Git est un outil de <em>système de contrôle de version</em> - une classe d'outils essentielle dans tout flux de développement. Il permet à un groupe de développeurs de travailler sur la même base de code sans se gêner mutuellement, stocke la base de code en toute sécurité dans un emplacement distant, permet aux développeurs de revenir à des états antérieurs si nécessaire, et plus encore.</li>
-  <li>GitHub est une application web qui fournit des outils utiles au-dessus de Git pour travailler avec des bases de code stockées, ainsi qu'un espace serveur pour stocker les bases de code. Elle fait des choses similaires à d'autres applications dans cet espace, comme <a href="https://about.gitlab.com/">GitLab</a> ou <a href="https://bitbucket.org/">Bitbucket</a>.</li>
-  <li>Chaque base de code est stockée dans un conteneur appelé <em>repository</em>, ou <em>repo</em>. En français « dépôt ».</li>
-  <li>Apporter une modification à un référentiel implique au minimum :
-    <ul>
-      <li>Créer votre propre copie de ce dépôt (appelé un <em>fork</em> ou « bifurcation »).</li>
-      <li>Créer une version différente du code dans votre bifurcation du dépôt (appelée une <em>branch</em> ou « branche ») et ajouter vos modifications à cette version alternative.</li>
-      <li>Proposer d'effectuer cette modification dans la copie originale du dépôt via une <em>pull request</em> ou « demande de triage ». Vous apprendrez toutes ces étapes dans ce guide.</li>
-    </ul>
-  </li>
-</ul>
+- Git est un outil de _système de contrôle de version_ - une classe d'outils essentielle dans tout flux de développement. Il permet à un groupe de développeurs de travailler sur la même base de code sans se gêner mutuellement, stocke la base de code en toute sécurité dans un emplacement distant, permet aux développeurs de revenir à des états antérieurs si nécessaire, et plus encore.
+- GitHub est une application web qui fournit des outils utiles au-dessus de Git pour travailler avec des bases de code stockées, ainsi qu'un espace serveur pour stocker les bases de code. Elle fait des choses similaires à d'autres applications dans cet espace, comme [GitLab](https://about.gitlab.com/) ou [Bitbucket](https://bitbucket.org/).
+- Chaque base de code est stockée dans un conteneur appelé _repository_, ou _repo_. En français « dépôt ».
+- Apporter une modification à un référentiel implique au minimum :
 
-<h2 id="assumptions_made_by_this_article">Hypothèses formulées par cet article</h2>
+  - Créer votre propre copie de ce dépôt (appelé un _fork_ ou « bifurcation »).
+  - Créer une version différente du code dans votre bifurcation du dépôt (appelée une _branch_ ou « branche ») et ajouter vos modifications à cette version alternative.
+  - Proposer d'effectuer cette modification dans la copie originale du dépôt via une _pull request_ ou « demande de triage ». Vous apprendrez toutes ces étapes dans ce guide.
 
-<p>Cet article part du principe que :</p>
+## Hypothèses formulées par cet article
 
-<ul>
-  <li>Vous êtes déjà à l'aise avec l'utilisation de la ligne de commande/du terminal. Si la ligne de commande vous est inconnue, lisez notre <a href="/fr/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line">Cours accéléré sur les lignes de commande</a>.</li>
-  <li>Vous travaillez sur un système qui comprend les commandes de ligne de commande standard de style Unix. macOS/Linux disposent de cette fonctionnalité dès le départ ; <a href="/fr/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line#windows">Windows n'est pas tout à fait aussi simple</a> à cet égard, mais il existe des applications utiles qui émulent cette fonctionnalité sous Windows, comme Git Bash.</li>
-  <li>Vous utiliserez la ligne de commande pour interagir avec Git/GitHub. Il existe un certain nombre d'outils GUI pour Git et GitHub, mais ils ne fonctionneront pas avec ce guide.</li>
-</ul>
+Cet article part du principe que :
 
-<h2 id="initial_setup">Configuration initiale</h2>
+- Vous êtes déjà à l'aise avec l'utilisation de la ligne de commande/du terminal. Si la ligne de commande vous est inconnue, lisez notre [Cours accéléré sur les lignes de commande](/fr/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line).
+- Vous travaillez sur un système qui comprend les commandes de ligne de commande standard de style Unix. macOS/Linux disposent de cette fonctionnalité dès le départ ; [Windows n'est pas tout à fait aussi simple](/fr/docs/Learn/Tools_and_testing/Understanding_client-side_tools/Command_line#windows) à cet égard, mais il existe des applications utiles qui émulent cette fonctionnalité sous Windows, comme Git Bash.
+- Vous utiliserez la ligne de commande pour interagir avec Git/GitHub. Il existe un certain nombre d'outils GUI pour Git et GitHub, mais ils ne fonctionneront pas avec ce guide.
 
-<p>Avant de commencer à travailler sur un dépôt particulier, suivez ces étapes :</p>
+## Configuration initiale
 
-<ol>
-  <li>Installez Git sur votre ordinateur. Allez sur la <a href="https://git-scm.com/downloads">page de téléchargement de Git</a>, téléchargez la dernière version pour votre ordinateur, et installez-la. Si vous êtes un utilisateur Windows, vous devriez également installer le paquet <a href="https://gitforwindows.org/">Git pour Windows</a>, qui inclut Gitbash.</li>
-  <li>Pendant que vous y êtes, installez les autres dépendances requises pour travailler localement avec MDN - <a href="https://nodejs.org/en/download/">Node.js</a> et <a href="https://classic.yarnpkg.com/en/docs/install">yarn</a>.
-    <ol>
-      <li>Installez Node.js en suivant le lien ci-dessus et en téléchargeant et installant la dernière version pour votre ordinateur.</li>
-      <li>Une fois que vous avez installé Node.js, installez yarn en exécutant <code>npm install --global yarn</code>.</li>
-    </ol>
-  </li>
-  <li>Créez un répertoire séparé quelque part sur votre ordinateur pour y stocker tous vos dépôts Git, qui soit facile à trouver et à atteindre en ligne de commande. Un répertoire appelé mdn-git à l'intérieur de votre répertoire home/user serait approprié.</li>
-  <li><a href="https://github.com/join">Créez un compte GitHub</a> si vous n'en avez pas déjà un. Vous aurez besoin d'un compte pour contribuer aux dépôts de MDN.</li>
-</ol>
+Avant de commencer à travailler sur un dépôt particulier, suivez ces étapes :
 
-<h3 id="setting_up_ssh_authentication_on_github">Configuration de l'authentification SSH sur GitHub</h3>
+1.  Installez Git sur votre ordinateur. Allez sur la [page de téléchargement de Git](https://git-scm.com/downloads), téléchargez la dernière version pour votre ordinateur, et installez-la. Si vous êtes un utilisateur Windows, vous devriez également installer le paquet [Git pour Windows](https://gitforwindows.org/), qui inclut Gitbash.
+2.  Pendant que vous y êtes, installez les autres dépendances requises pour travailler localement avec MDN - [Node.js](https://nodejs.org/en/download/) et [yarn](https://classic.yarnpkg.com/en/docs/install).
 
-<p>À ce stade, vous devez configurer une clé SSH sur votre compte GitHub. Il s'agit essentiellement d'un mécanisme de sécurité qui vous identifie auprès de GitHub et vous évite de devoir vous authentifier à chaque fois que vous utilisez les services GitHub.</p>
+    1.  Installez Node.js en suivant le lien ci-dessus et en téléchargeant et installant la dernière version pour votre ordinateur.
+    2.  Une fois que vous avez installé Node.js, installez yarn en exécutant `npm install --global yarn`.
 
-<p>GitHub a créé un guide utile pour configurer cela - voir le point de départ sur <a href="https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh">Connexion à GitHub avec SSH</a>. Suivez chacune des étapes ici pour vous configurer avec SSH sur GitHub.</p>
+3.  Créez un répertoire séparé quelque part sur votre ordinateur pour y stocker tous vos dépôts Git, qui soit facile à trouver et à atteindre en ligne de commande. Un répertoire appelé mdn-git à l'intérieur de votre répertoire home/user serait approprié.
+4.  [Créez un compte GitHub](https://github.com/join) si vous n'en avez pas déjà un. Vous aurez besoin d'un compte pour contribuer aux dépôts de MDN.
 
-<p>Si vous ne le faites pas, vous pourrez toujours contribuer au MDN, mais vous devrez saisir votre nom d'utilisateur et votre mot de passe à chaque fois que vous interagirez avec GitHub (par exemple, lorsque vous soumettez une demande de triage, comme indiqué ci-dessous).</p>
+### Configuration de l'authentification SSH sur GitHub
 
-<h2 id="setting_up_to_work_on_a_specific_repo">Se préparer à travailler sur un dépôt spécifique</h2>
+À ce stade, vous devez configurer une clé SSH sur votre compte GitHub. Il s'agit essentiellement d'un mécanisme de sécurité qui vous identifie auprès de GitHub et vous évite de devoir vous authentifier à chaque fois que vous utilisez les services GitHub.
+
+GitHub a créé un guide utile pour configurer cela - voir le point de départ sur [Connexion à GitHub avec SSH](https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh). Suivez chacune des étapes ici pour vous configurer avec SSH sur GitHub.
+
+Si vous ne le faites pas, vous pourrez toujours contribuer au MDN, mais vous devrez saisir votre nom d'utilisateur et votre mot de passe à chaque fois que vous interagirez avec GitHub (par exemple, lorsque vous soumettez une demande de triage, comme indiqué ci-dessous).
+
+## Se préparer à travailler sur un dépôt spécifique
 
 <!-- start:Note spéciale pour l'équpe de traduction l10n-fr -->
-<div class="note">
-  <p><strong>Note :</strong> pour la traduction française :</p>
-  <p>Ce qui a été expliqué par Chris Mills ici est identique pour le dépôt de traduction français, vous devez remplacer <code>mdn/content</code> par <code>mdn/translated-content</code>, et <code>&lt;votre-nom-utilisateur&gt;/content</code> par <code>&lt;votre-nom-utilisateur&gt;/translated-content</code></p>
-  <p>Vous pouvez retrouver des explications de ceci sur notre article <a href="https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer">Comment contribuer sur GitHub au MDN</a></p>
-</div>
+
+> **Note :** pour la traduction française :
+>
+> Ce qui a été expliqué par Chris Mills ici est identique pour le dépôt de traduction français, vous devez remplacer `mdn/content` par `mdn/translated-content`, et `<votre-nom-utilisateur>/content` par `<votre-nom-utilisateur>/translated-content`
+>
+> Vous pouvez retrouver des explications de ceci sur notre article [Comment contribuer sur GitHub au MDN](https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer)
+
 <!-- end:Note spéciale pour l'équpe de traduction l10n-fr -->
 
-<p>Il existe un certain nombre de dépôts différents que vous pouvez avoir à mettre à jour lorsque vous travaillez sur différentes tâches MDN (voir <a href="/fr/docs/MDN/Contribute/Where_is_everything">Où se trouve tout sur MDN ? Un guide de nos dépôts</a>), mais il y a un certain nombre d'étapes de configuration que vous devriez suivre sur chaque dépôt sur lequel vous travaillez, pour rendre les choses plus faciles et plus cohérentes.</p>
+Il existe un certain nombre de dépôts différents que vous pouvez avoir à mettre à jour lorsque vous travaillez sur différentes tâches MDN (voir [Où se trouve tout sur MDN ? Un guide de nos dépôts](/fr/docs/MDN/Contribute/Where_is_everything)), mais il y a un certain nombre d'étapes de configuration que vous devriez suivre sur chaque dépôt sur lequel vous travaillez, pour rendre les choses plus faciles et plus cohérentes.
+
+### Bifurcation et clonage
+
+La _Bifurcation_ et le _Clonage_ sont deux termes que vous rencontrerez souvent dans le monde de Git :
+
+- « Forking » (ou Bifurquer) signifie créer votre propre copie d'un dépôt sur GitHub.
+- « Cloning » (ou Cloner) consiste à faire une copie locale d'un dépôt sur lequel vous pouvez travailler (c'est-à-dire sur votre disque dur local).
+
+Il est possible de faire les deux choses séparément, mais en pratique, vous les ferez presque toujours ensemble lorsque vous contribuerez aux projets d'autres personnes. Vous devez d'abord créer une bifurcation de chaque dépôt sur lequel vous souhaitez travailler. Cela est nécessaire pour soumettre des demandes de modification à la version principale du dépôt (nous verrons plus tard comment créer une demande de modification). Pour des raisons de sécurité, vous ne pouvez pas soumettre des modifications directement à la version principale du dépôt.
+
+Bifurquons le dépôt <https://github.com/mdn/content> dès maintenant ; vous contribuerez certainement à ce dépôt à un moment donné. Suivez les étapes suivantes :
+
+1.  Localisez le bouton « Fork » dans le coin supérieur droit de la page du dépôt de contenu, et appuyez dessus :
+
+    ![Bouton étiqueté fork, avec le numéro 609 à côté.](fork-button.png)
+
+2.  Une fenêtre de dialogue s'affiche, vous demandant où vous souhaitez transférer le dépôt. Sélectionnez votre compte GitHub personnel.
+
+    Un message apparaîtra disant quelque chose comme « Forking mdn/content. It should only take a few seconds. ». Une fois que GitHub a terminé la bifurcation, votre navigateur devrait vous rediriger vers la page du nouveau « fork ». À titre d'exemple, mon « fork » de <https://github.com/mdn/content> est disponible l'adresse <https://github.com/chrisdavidmills/content>.
+
+Maintenant que vous avez dupliqué le dépôt, il est temps de cloner votre copie localement. Pour ce faire :
+
+1.  Allez sur la page de votre bifurcation sur github.com (par exemple `https://github.com/<votre-nom-utilisateur>/content`).
+2.  Appuyez sur le bouton vert « Code » en haut de la liste des fichiers. Quelque chose de similaire à la fenêtre contextuelle suivante devrait apparaître :
+
+    ![Fenêtre contextuelle montrant une URL de clonage avec les options d'ouverture via le bureau GitHub et de téléchargement du zip.](code-popup.png)
+
+3.  Si vous avez configuré l'authentification SSH comme indiqué ci-dessus, cliquez sur l'onglet "SSH" et copiez l'URL `git@github.com:<votre-nom-utilisateur>/content.git` à partir du champ de texte de la fenêtre de dialogue. Si vous n'avez pas configuré l'authentification SSH, copiez plutôt l'URL depuis le champ de texte de l'onglet "HTTPS", qui devrait ressembler à ceci : `https://github.com/<votre-nom-utilisateur>/content.git`.
+4.  Maintenant, ouvrez votre console de commande sur votre ordinateur, et naviguez dans le répertoire que vous avez configuré plus tôt pour stocker les clones de votre dépôt git local à l'aide de la commande cd, par ex.
+
+    ```bash
+    cd git
+    ```
+
+5.  Clonez votre bifurcation en entrant une commande de la forme suivante :
+
+    ```bash
+    git clone url-que-vous-avez-copié
+    ```
+
+    Ainsi, par exemple, ma commande de clonage ressemblait à ceci :
+
+    ```bash
+    git clone git@github.com:chrisdavidmills/content.git
+    ```
+
+Vous devriez maintenant trouver un répertoire de contenu dans votre répertoire git, contenant le contenu du dépôt.
+
+### Configuration d'un suivi distant pour pointer vers la version principale du dépôt
+
+La dernière chose à faire avant de passer à autre chose, c'est de configurer un _remote_ ou « suivi distant » pour pointer vers la version principale du dépôt, par exemple <https://github.com/mdn/content> dans le cas de notre exemple. Un suivi distant est essentiellement un pointeur vers un emplacement de dépôt distant spécifique sur GitHub, et est le plus souvent utilisé pour mettre à jour votre clone local afin qu'il soit à jour avec le dernier dépôt principal, comme nous le verrons ci-dessous.
+
+La configuration d'un suivi distant se fait avec la commande `git remote add`, qui ressemble à ceci :
+
+```bash
+git remote add remote-name repo-you-want-to-point-to
+```
+
+- `remote-name` est le nom que vous décidez, qui est utilisé pour se référer à suivi distant plus tard. Il est bon de s'en tenir à un nom cohérent pour bien distinguer les différents dépôts qui ont le même but, ainsi le même nom de suivi fera la même chose partout, et vous êtes moins susceptibles d'être confus. Ainsi, par exemple, la version principale du dépôt à partir duquel vous avez bifurqué votre version est souvent appelée « dépôt ascendant », c'est pourquoi les gens utilisent souvent « upstream » comme nom de l'emplacement ascendant distant. J'appelle généralement mes suivi ascendant "mozilla", pour signifier qu'ils pointent vers la copie principale du dépôt de Mozilla.
+- `repo-you-want-to-point-to` est l'URL SSH (ou HTTPS) du dépôt vers lequel vous voulez pointer, récupérée de la même manière que lorsque nous avons cloné notre bifurcation plus tôt.
+
+Donc, pour ajouter votre suivi :
+
+1.  Allez sur la page github.com de la version principale du dépôt (<https://github.com/mdn/content> dans cet exemple) et récupérez l'URL SSH ou HTTPS selon le cas, dans la fenêtre contextuelle « Code ».
+2.  Dans votre console de commande, utilisez `cd` pour aller dans votre répertoire de contenu :
+
+    ```bash
+    cd content
+    ```
+
+3.  Exécutez maintenant une commande selon les lignes suivantes, en remplaçant _remote-name_ et _repo-you-want-to-point-to_ comme il convient :
+
+    ```bash
+    git remote add remote-name repo-you-want-to-point-to
+    ```
+
+    Ainsi, par exemple, j'ai utilisé l'URL SSH et j'ai appelé mon suivi distant "mozilla" :
+
+    ```bash
+    git remote add mozilla git@github.com:mdn/content.git
+    ```
+
+Votre suivi distant devrait maintenant être configuré. Vous pouvez le vérifier en exécutant la commande `git remote -v` dans votre terminal, qui sort une liste de vos noms de suivi distant et où ils pointent. Vous devriez voir quelque chose un peu comme ceci :
+
+    mozilla    git@github.com:mdn/content.git (fetch)
+    mozilla    git@github.com:mdn/content.git (push)
+    origin    git@github.com:chrisdavidmills/content.git (fetch)
+    origin    git@github.com:chrisdavidmills/content.git (push)
+
+## Préparation d'une modification du dépôt.
+
+Maintenant que votre clone de fork local est prêt à fonctionner, il y a un ensemble de commandes que vous devez prendre l'habitude d'exécuter avant d'essayer d'effectuer de nouvelles modifications.
+
+### Passer à la branche principale
 
-<h3 id="forking_and_cloning">Bifurcation et clonage</h3>
+Chaque dépôt a un certain nombre de branches différentes, qui sont essentiellement des versions différentes du code de base dans le même dépôt. L'idée est que pour chaque modification apportée au code de base, vous effectuez la modification sur une branche séparée et la testez d'abord, avant de pousser les modifications vers la copie principale du code.
 
-<p>La <em>Bifurcation</em> et le <em>Clonage</em> sont deux termes que vous rencontrerez souvent dans le monde de Git :</p>
+La branche principale du dépôt de contenu est appelée « main » (elle peut être appelée autrement, comme « master » dans d'autres dépôts, et si c'est le cas, vous devrez mettre à jour son nom dans toutes les commandes présentées ci-dessous). Vous serez sur cette branche par défaut si vous venez de cloner le dépôt, mais si vous avez déjà effectué des modifications, vous serez probablement sur une autre branche.
 
-<ul>
-  <li>« Forking » (ou Bifurquer) signifie créer votre propre copie d'un dépôt sur GitHub.</li>
-  <li>« Cloning » (ou Cloner) consiste à faire une copie locale d'un dépôt sur lequel vous pouvez travailler (c'est-à-dire sur votre disque dur local).</li>
-</ul>
+Assurez-vous d'exécuter la commande suivante pour passer à la branche principale avant de faire quoi que ce soit d'autre :
 
-<p>Il est possible de faire les deux choses séparément, mais en pratique, vous les ferez presque toujours ensemble lorsque vous contribuerez aux projets d'autres personnes. Vous devez d'abord créer une bifurcation de chaque dépôt sur lequel vous souhaitez travailler. Cela est nécessaire pour soumettre des demandes de modification à la version principale du dépôt (nous verrons plus tard comment créer une demande de modification). Pour des raisons de sécurité, vous ne pouvez pas soumettre des modifications directement à la version principale du dépôt.</p>
+```bash
+git switch main
+```
 
-<p>Bifurquons le dépôt <a href="https://github.com/mdn/content">https://github.com/mdn/content</a> dès maintenant ; vous contribuerez certainement à ce dépôt à un moment donné. Suivez les étapes suivantes :</p>
+> **Note :** Dans d'autres tutoriels, vous avez peut-être vu `git checkout` utilisée pour changer de branche dans un dépôt. Cela fonctionne bien la plupart du temps, mais peut parfois avoir des effets secondaires involontaires, c'est pourquoi dans ce tutoriel nous recommandons la commande `git switch`, plus récente, qui est conçue pour changer de branche et a moins de chance de faire des erreurs. Si vous êtes intéressé par la façon dont ces commandes sont liées, et les différences entre elles, l'article [Les points forts de Git 2.23 > Alternatives expérimentales pour git checkout](https://github.blog/2019-08-16-highlights-from-git-2-23/#experimental-alternatives-for-git-checkout) fournit un bon résumé.
 
-<ol>
-  <li>
-    <p>Localisez le bouton « Fork » dans le coin supérieur droit de la page du dépôt de contenu, et appuyez dessus :</p>
-    <p><img src="fork-button.png" alt="Bouton étiqueté fork, avec le numéro 609 à côté."></p>
-  </li>
-  <li>
-    <p>Une fenêtre de dialogue s'affiche, vous demandant où vous souhaitez transférer le dépôt. Sélectionnez votre compte GitHub personnel.</p>
-    <p>Un message apparaîtra disant quelque chose comme « Forking mdn/content. It should only take a few seconds. ». Une fois que GitHub a terminé la bifurcation, votre navigateur devrait vous rediriger vers la page du nouveau « fork ». À titre d'exemple, mon « fork » de <a href="https://github.com/mdn/content">https://github.com/mdn/content</a> est disponible  l'adresse <a href="https://github.com/chrisdavidmills/content">https://github.com/chrisdavidmills/content</a>.</p>
-  </li>
-</ol>
+### Mettre à jour votre branche principale
 
-<p>Maintenant que vous avez dupliqué le dépôt, il est temps de cloner votre copie localement. Pour ce faire :</p>
-
-<ol>
-  <li>
-    <p>Allez sur la page de votre bifurcation sur github.com (par exemple <code>https://github.com/<em>&lt;votre-nom-utilisateur&gt;</em>/content</code>).</p>
-  </li>
-  <li>
-    <p>Appuyez sur le bouton vert « Code » en haut de la liste des fichiers. Quelque chose de similaire à la fenêtre contextuelle suivante devrait apparaître :</p>
-    <p><img src="code-popup.png" alt="Fenêtre contextuelle montrant une URL de clonage avec les options d'ouverture via le bureau GitHub et de téléchargement du zip."></p>
-  </li>
-  <li>
-    <p>Si vous avez configuré l'authentification SSH comme indiqué ci-dessus, cliquez sur l'onglet "SSH" et copiez l'URL <code>git@github.com:<em>&lt;votre-nom-utilisateur&gt;</em>/content.git</code> à partir du champ de texte de la fenêtre de dialogue. Si vous n'avez pas configuré l'authentification SSH, copiez plutôt l'URL depuis le champ de texte de l'onglet "HTTPS", qui devrait ressembler à ceci : <code>https://github.com/<em>&lt;votre-nom-utilisateur&gt;</em>/content.git</code>.</p>
-  </li>
-  <li>
-    <p>Maintenant, ouvrez votre console de commande sur votre ordinateur, et naviguez dans le répertoire que vous avez configuré plus tôt pour stocker les clones de votre dépôt git local à l'aide de la commande cd, par ex.</p>
-    <pre class="brush: bash">cd git</pre>
-  </li>
-  <li>
-    <p>Clonez votre bifurcation en entrant une commande de la forme suivante :</p>
-    <pre class="brush: bash">git clone <em>url-que-vous-avez-copié</em></pre>
-    <p>Ainsi, par exemple, ma commande de clonage ressemblait à ceci :</p>
-    <pre class="brush: bash">git clone git@github.com:chrisdavidmills/content.git</pre>
-  </li>
-</ol>
-
-<p>Vous devriez maintenant trouver un répertoire de contenu dans votre répertoire git, contenant le contenu du dépôt.</p>
-
-<h3 id="setting_up_a_remote_to_point_to_the_main_version_of_the_repo">Configuration d'un suivi distant pour pointer vers la version principale du dépôt</h3>
-
-<p>La dernière chose à faire avant de passer à autre chose, c'est de configurer un <em>remote</em> ou « suivi distant » pour pointer vers la version principale du dépôt, par exemple <a href="https://github.com/mdn/content">https://github.com/mdn/content</a> dans le cas de notre exemple. Un suivi distant est essentiellement un pointeur vers un emplacement de dépôt distant spécifique sur GitHub, et est le plus souvent utilisé pour mettre à jour votre clone local afin qu'il soit à jour avec le dernier dépôt principal, comme nous le verrons ci-dessous.</p>
-
-<p>La configuration d'un suivi distant se fait avec la commande <code>git remote add</code>, qui ressemble à ceci :</p>
-
-<pre class="brush: bash">git remote add remote-name repo-you-want-to-point-to</pre>
-
-<ul>
-  <li><code><em>remote-name</em></code> est le nom que vous décidez, qui est utilisé pour se référer à suivi distant plus tard. Il est bon de s'en tenir à un nom cohérent pour bien distinguer les différents dépôts qui ont le même but, ainsi le même nom de suivi fera la même chose partout, et vous êtes moins susceptibles d'être confus. Ainsi, par exemple, la version principale du dépôt à partir duquel vous avez bifurqué votre version est souvent appelée « dépôt ascendant », c'est pourquoi les gens utilisent souvent « upstream » comme nom de l'emplacement ascendant distant. J'appelle généralement mes suivi ascendant "mozilla", pour signifier qu'ils pointent vers la copie principale du dépôt de Mozilla.</li>
-  <li><code><em>repo-you-want-to-point-to</em></code> est l'URL SSH (ou HTTPS) du dépôt vers lequel vous voulez pointer, récupérée de la même manière que lorsque nous avons cloné notre bifurcation plus tôt.</li>
-</ul>
-
-<p>Donc, pour ajouter votre suivi :</p>
-
-<ol>
-  <li>
-    <p>Allez sur la page github.com de la version principale du dépôt (<a href="https://github.com/mdn/content">https://github.com/mdn/content</a> dans cet exemple) et récupérez l'URL SSH ou HTTPS selon le cas, dans la fenêtre contextuelle « Code ».</p>
-  </li>
-  <li>
-    <p>Dans votre console de commande, utilisez <code>cd</code> pour aller dans votre répertoire de contenu :</p>
-    <pre class="brush: bash">cd content</pre>
-  </li>
-  <li>
-    <p>Exécutez maintenant une commande selon les lignes suivantes, en remplaçant <em>remote-name</em> et <em>repo-you-want-to-point-to</em> comme il convient :</p>
-    <pre class="brush: bash">git remote add <em>remote-name</em> <em>repo-you-want-to-point-to</em></pre>
-    <p>Ainsi, par exemple, j'ai utilisé l'URL SSH et j'ai appelé mon suivi distant "mozilla" :</p>
-    <pre class="brush: bash">git remote add mozilla git@github.com:mdn/content.git</pre>
-  </li>
-</ol>
-
-<p>Votre suivi distant devrait maintenant être configuré. Vous pouvez le vérifier en exécutant la commande <code>git remote -v</code> dans votre terminal, qui sort une liste de vos noms de suivi distant et où ils pointent. Vous devriez voir quelque chose un peu comme ceci :</p>
-
-<pre>mozilla    git@github.com:mdn/content.git (fetch)
-mozilla    git@github.com:mdn/content.git (push)
-origin    git@github.com:chrisdavidmills/content.git (fetch)
-origin    git@github.com:chrisdavidmills/content.git (push)</pre>
-
-<h2 id="preparing_to_make_a_change_to_the_repo">Préparation d'une modification du dépôt.</h2>
+Ensuite, vous devez mettre à jour votre branche principale afin qu'elle contienne le même contenu que la branche principale du dépôt principal. Le dépôt de contenu est mis à jour plusieurs fois par jour par un grand nombre de contributeurs, donc si vous ne le faites pas, votre version ne sera plus à jour, ce qui posera des problèmes lorsque vous essaierez de soumettre vos mises à jour. C'est là que votre suivi distant vous sera utile !
 
-<p>Maintenant que votre clone de fork local est prêt à fonctionner, il y a un ensemble de commandes que vous devez prendre l'habitude d'exécuter avant d'essayer d'effectuer de nouvelles modifications.</p>
+Pour mettre à jour votre dépôt :
 
-<h3 id="switch_to_the_main_branch">Passer à la branche principale</h3>
+1.  Tout d'abord, récupérez le contenu mis à jour de votre suivi distant avec la commande suivante :
 
-<p>Chaque dépôt a un certain nombre de branches différentes, qui sont essentiellement des versions différentes du code de base dans le même dépôt. L'idée est que pour chaque modification apportée au code de base, vous effectuez la modification sur une branche séparée et la testez d'abord, avant de pousser les modifications vers la copie principale du code.</p>
+    ```bash
+    git fetch remote-name
+    ```
 
-<p>La branche principale du dépôt de contenu est appelée « main » (elle peut être appelée autrement, comme « master » dans d'autres dépôts, et si c'est le cas, vous devrez mettre à jour son nom dans toutes les commandes présentées ci-dessous). Vous serez sur cette branche par défaut si vous venez de cloner le dépôt, mais si vous avez déjà effectué des modifications, vous serez probablement sur une autre branche.</p>
+    Par exemple :
 
-<p>Assurez-vous d'exécuter la commande suivante pour passer à la branche principale avant de faire quoi que ce soit d'autre :</p>
+    ```bash
+    git fetch mozilla
+    ```
 
-<pre class="brush: bash">git switch main</pre>
+2.  Ensuite, remplacez le contenu de votre branche principale par la branche principale du dépôt distant. Il existe de nombreuses façons différentes de le faire, mais j'ai tendance à utiliser la commande `rebase`, comme ceci :
 
-<div class="note">
-  <p><strong>Note :</strong> Dans d'autres tutoriels, vous avez peut-être vu <code>git checkout</code> utilisée pour changer de branche dans un dépôt. Cela fonctionne bien la plupart du temps, mais peut parfois avoir des effets secondaires involontaires, c'est pourquoi dans ce tutoriel nous recommandons la commande <code>git switch</code>, plus récente, qui est conçue pour changer de branche et a moins de chance de faire des erreurs. Si vous êtes intéressé par la façon dont ces commandes sont liées, et les différences entre elles, l'article <a href="https://github.blog/2019-08-16-highlights-from-git-2-23/#experimental-alternatives-for-git-checkout">Les points forts de Git 2.23 > Alternatives expérimentales pour git checkout</a> fournit un bon résumé.</p>
-</div>
-
-<h3 id="update_your_main_branch">Mettre à jour votre branche principale</h3>
+    ```bash
+    git rebase remote-name/main-branch-name
+    ```
 
-<p>Ensuite, vous devez mettre à jour votre branche principale afin qu'elle contienne le même contenu que la branche principale du dépôt principal. Le dépôt de contenu est mis à jour plusieurs fois par jour par un grand nombre de contributeurs, donc si vous ne le faites pas, votre version ne sera plus à jour, ce qui posera des problèmes lorsque vous essaierez de soumettre vos mises à jour. C'est là que votre suivi distant vous sera utile !</p>
-
-<p>Pour mettre à jour votre dépôt :</p>
-
-<ol>
-  <li>
-    <p>Tout d'abord, récupérez le contenu mis à jour de votre suivi distant avec la commande suivante :</p>
-    <pre class="brush: bash">git fetch <em>remote-name</em></pre>
-    <p>Par exemple :</p>
-    <pre class="brush: bash">git fetch mozilla</pre>
-  </li>
-  <li>
-    <p>Ensuite, remplacez le contenu de votre branche principale par la branche principale du dépôt distant. Il existe de nombreuses façons différentes de le faire, mais j'ai tendance à utiliser la commande <code>rebase</code>, comme ceci :</p>
-    <pre class="brush: bash">git rebase <em>remote-name</em>/<em>main-branch-name</em></pre>
-    <p>Par exemple :<p>
-    <pre class="brush: bash">git rebase mozilla/main</pre>
-  </li>
-  <li>
-    <p>Enfin, poussez ces changements vers la version distante de votre bifircation en utilisant :</p>
-    <pre class="brush: bash">git push</pre>
-  </li>
-</ol>
-
-<p>Vous saurez si vos mises à jour ont fonctionné correctement en regardant la page github.com de votre fork (c-à-d. que la mienne est <a href="https://github.com/chrisdavidmills/content">https://github.com/chrisdavidmills/content</a>). Elle devrait dire quelque chose comme « This branch is even with mdn:main. » quelque part près du haut de page. Si cela dit que votre branche principale est derrière mdn:main par un certain nombre de commits, alors vous devrez essayer à nouveau, ou regarder la section <a href="#troubleshooting">dépannage</a>.</p>
-
-<h3 id="create_a_new_branch_to_do_your_work_in">Créez une nouvelle branche pour y faire vos modifications</h3>
-
-<p>Une fois que vous avez mis à jour votre branche principale dans votre bifurcation, vous devez toujours créer une nouvelle branche pour y apporter une modification. Vous ne devriez <em>jamais</em> faire vos modifications dans la branche principale et le soumettre à partir de là - cela peut devenir très vite désordonné, croyez-nous. Il est beaucoup plus propre et moins sujet aux erreurs de faire tout le travail dans des branches séparées.</p>
-
-<p>Pour créer une nouvelle branche :</p>
+    Par exemple :
 
-<ol>
-  <li>
-    <p>Allez sur la page de votre bifurcation sur github.com (la mienne est à l'adresse <a href="https://github.com/chrisdavidmills/content">https://github.com/chrisdavidmills/content</a>) et trouvez le bouton de branche en haut à gauche de la liste des fichiers, qui devrait indiquer « main » :</p>
-    <p><img src="branch-button.png" alt="Bouton intitulé main"></p>
-  </li>
-  <li>
-    <p>Cliquez dessus, et vous verrez apparaître une liste de branches et un champ de texte indiquant « Find or create a branch… » :</p>
-    <p><img src="branch-menu.png" alt="menu montrant une liste de noms de branches avec une zone de texte étiquetée trouver ou créer une branche"></p>
-  </li>
-  <li>
-    <p>Si vous saisissez une partie du nom d'une branche existante dans le champ de texte, la liste des branches sera filtrée en fonction de cette chaîne de caractères, ce qui vous permettra de rechercher facilement des branches existantes. Cependant, nous voulons créer une nouvelle branche. Entrez un nom de branche qui n'existe pas encore (essayez quelque chose comme test-branch) et l'affichage changera pour vous donner un bouton intitulé « Create branch : test-branch from 'main' » :</p>
-    <p><img src="new-branch.png" alt="menu montrant un nouveau nom de branche, test-branch, entré dans une zone de texte, avec un bouton de création de branche en dessous"></p>
-  </li>
-  <li>
-    <p>Une fois que vous êtes satisfait du nom de votre branche, cliquez sur ce bouton, et l'affichage sera mis à jour pour montrer le nom de la branche dans le bouton branche :</p>
-    <p><img src="branch-button-new-branch.png" alt="Bouton intitulé test-branch"></p>
-  </li>
-</ol>
+    ```bash
+    git rebase mozilla/main
+    ```
 
-<p>Voilà, c'est fait ! Vous avez maintenant créé une nouvelle branche dans laquelle vous allez travailler. Cette branche est identique à l'état de la branche principale au moment où vous l'avez créée. C'est un bon point de départ pour notre travail.</p>
-
-<p>Conseils :</p>
+3.  Enfin, poussez ces changements vers la version distante de votre bifircation en utilisant :
 
-<ul>
-  <li>Assurez-vous de toujours mettre à jour votre branche principale pour qu'elle soit synchronisée avec la branche principale de mozilla, comme indiqué dans la section précédente, avant de créer une nouvelle branche.</li>
-  <li>Assurez-vous de toujours créer votre nouvelle branche en vous basant sur main, et non sur une autre branche, en vérifiant que le bouton de la branche affiche "main" avant de lancer le processus. Si vous ne le faites pas, votre nouvelle branche risque d'être vraiment obsolète, ce qui créera des problèmes de contenu.</li>
-</ul>
-
-<h3 id="get_your_branch_locally_and_switch_to_it">Obtenez votre branche localement et passez dessus</h3>
-
-<p>La section précédente vous a appris à créer une nouvelle branche dans votre bifurcation, mais elle n'existe actuellement que dans votre version distante du dépôt. Pour travailler dessus, vous devez la placer dans votre version locale.</p>
+    ```bash
+    git push
+    ```
 
-<p>Pour ce faire, retournez dans votre terminal et, en vous assurant que vous êtes à l'intérieur du répertoire du dépôt sur lequel vous travaillez (<code>content</code> pour cet exemple) :</p>
+Vous saurez si vos mises à jour ont fonctionné correctement en regardant la page github.com de votre fork (c-à-d. que la mienne est <https://github.com/chrisdavidmills/content>). Elle devrait dire quelque chose comme « This branch is even with mdn:main. » quelque part près du haut de page. Si cela dit que votre branche principale est derrière mdn:main par un certain nombre de commits, alors vous devrez essayer à nouveau, ou regarder la section [dépannage](#troubleshooting).
 
-<ol>
-  <li>Tirez les changements distants vers votre clone local en exécutant la commande <code>git pull</code>.</li>
-  <li>Vous devriez obtenir un message du type <code>* [new branch] test-branch -> origin/test-branch</code>.</li>
-  <li>Pour passer à votre branche (c'est-à-dire passer de « main », pour travailler dans cette branche à la place), exécutez la commande <code>git switch test-branch</code>.</li>
-</ol>
+### Créez une nouvelle branche pour y faire vos modifications
 
-<p>Si vous avez réussi, git devrait vous dire quelque chose comme ceci :</p>
+Une fois que vous avez mis à jour votre branche principale dans votre bifurcation, vous devez toujours créer une nouvelle branche pour y apporter une modification. Vous ne devriez _jamais_ faire vos modifications dans la branche principale et le soumettre à partir de là - cela peut devenir très vite désordonné, croyez-nous. Il est beaucoup plus propre et moins sujet aux erreurs de faire tout le travail dans des branches séparées.
 
-<pre>Branch 'test-branch' set up to track remote branch 'test-branch' from 'origin'.
-Switched to a new branch 'test-branch'</pre>
+Pour créer une nouvelle branche :
 
-<p>Notez que vous pouvez vérifier le statut de votre dépôt, y compris la branche sur laquelle vous vous trouvez, à tout moment en exécutant la commande <code>git status</code>. Essayez maintenant, et git devrait vous dire quelque chose comme ceci :</p>
+1.  Allez sur la page de votre bifurcation sur github.com (la mienne est à l'adresse <https://github.com/chrisdavidmills/content>) et trouvez le bouton de branche en haut à gauche de la liste des fichiers, qui devrait indiquer « main » :
 
-<pre>On branch test-branch
-Your branch is up to date with 'origin/test-branch'.
+    ![Bouton intitulé main](branch-button.png)
 
-nothing to commit, working tree clean</pre>
+2.  Cliquez dessus, et vous verrez apparaître une liste de branches et un champ de texte indiquant « Find or create a branch… » :
 
-<p>Cela semble correct. Nous sommes sur la branche "test-branch", et nous n'avons pas encore fait de changements.</p>
+    ![menu montrant une liste de noms de branches avec une zone de texte étiquetée trouver ou créer une branche](branch-menu.png)
 
-<h2 id="adding_committing_and_pushing_changes">Ajouter, valider et pousser les changements</h2>
+3.  Si vous saisissez une partie du nom d'une branche existante dans le champ de texte, la liste des branches sera filtrée en fonction de cette chaîne de caractères, ce qui vous permettra de rechercher facilement des branches existantes. Cependant, nous voulons créer une nouvelle branche. Entrez un nom de branche qui n'existe pas encore (essayez quelque chose comme test-branch) et l'affichage changera pour vous donner un bouton intitulé « Create branch : test-branch from 'main' » :
 
-<p>À ce stade, vous êtes prêt à apporter des modifications au dépôt sur lequel vous travaillez, pour corriger un bogue sur lu MDN ou autre. Nous allons sauter cette partie, car ce n'est pas le but de ce tutoriel. Si vous voulez corriger un vrai problème sur le MDN, allez choisir un bogue à corriger dans notre <a href="https://github.com/mdn/translated-content/issues/">liste des problèmes de contenu</a>, ou lisez <a href="/fr/docs/MDN/Contribute">Contribuer à MDN</a> pour plus de conseils.</p>
-
-<p>Si vous voulez simplement suivre ce tutoriel à titre d'exemple, faisons quelque chose de simple.</p>
-
-<ol>
-  <li>
-    <p>Allez dans le fichier <code>content/README.md</code>, et ajoutez une seule lettre dans le titre supérieur du README.</p>
-  </li>
-  <li>
-    <p>Maintenant, retournez à votre ligne de commande et entrez à nouveau la commande <code>git status</code>. Cette fois-ci, git devrait vous dire quelque chose comme ceci :</p>
-    <pre>Your branch is up to date with 'origin/test-branch'.
-
-    Changes not staged for commit:
-      (use "git add &lt;file&gt;..." to update what will be committed)
-      (use "git restore &lt;file&gt;..." to discard changes in working directory)
-        modified:   README.md
-
-    no changes added to commit (use "git add" and/or "git commit -a")</pre>
-  </li>
-  <li>
-    <p>À ce stade, il vous indique donc les fichiers que vous avez modifiés. L'étape suivante consiste à les "ajouter", c'est-à-dire à les ajouter à une liste de fichiers que vous souhaitez commiter pour les pousser vers le fork distant. Pour ajouter ce fichier à la liste de commit, tapez ce qui suit :</p>
-    <pre class="brush: bash">git add README.md</pre>
-    <div class="note">
-      <p><strong>Note :</strong> <code>README.md</code> est le chemin d'accès au fichier que vous avez modifié, pas seulement son nom. S'il était à l'intérieur d'un sous-répertoire, vous auriez dû écrire le chemin complet du fichier.</p>
-    </div>
-  </li>
-  <li>
-    <p>Si vous exécutez <code>git status</code> à nouveau, vous verrez maintenant ceci :</p>
-    <pre>On branch test-branch
+    ![menu montrant un nouveau nom de branche, test-branch, entré dans une zone de texte, avec un bouton de création de branche en dessous](new-branch.png)
+
+4.  Une fois que vous êtes satisfait du nom de votre branche, cliquez sur ce bouton, et l'affichage sera mis à jour pour montrer le nom de la branche dans le bouton branche :
+
+    ![Bouton intitulé test-branch](branch-button-new-branch.png)
+
+Voilà, c'est fait ! Vous avez maintenant créé une nouvelle branche dans laquelle vous allez travailler. Cette branche est identique à l'état de la branche principale au moment où vous l'avez créée. C'est un bon point de départ pour notre travail.
+
+Conseils :
+
+- Assurez-vous de toujours mettre à jour votre branche principale pour qu'elle soit synchronisée avec la branche principale de mozilla, comme indiqué dans la section précédente, avant de créer une nouvelle branche.
+- Assurez-vous de toujours créer votre nouvelle branche en vous basant sur main, et non sur une autre branche, en vérifiant que le bouton de la branche affiche "main" avant de lancer le processus. Si vous ne le faites pas, votre nouvelle branche risque d'être vraiment obsolète, ce qui créera des problèmes de contenu.
+
+### Obtenez votre branche localement et passez dessus
+
+La section précédente vous a appris à créer une nouvelle branche dans votre bifurcation, mais elle n'existe actuellement que dans votre version distante du dépôt. Pour travailler dessus, vous devez la placer dans votre version locale.
+
+Pour ce faire, retournez dans votre terminal et, en vous assurant que vous êtes à l'intérieur du répertoire du dépôt sur lequel vous travaillez (`content` pour cet exemple) :
+
+1.  Tirez les changements distants vers votre clone local en exécutant la commande `git pull`.
+2.  Vous devriez obtenir un message du type `* [new branch] test-branch -> origin/test-branch`.
+3.  Pour passer à votre branche (c'est-à-dire passer de « main », pour travailler dans cette branche à la place), exécutez la commande `git switch test-branch`.
+
+Si vous avez réussi, git devrait vous dire quelque chose comme ceci :
+
+    Branch 'test-branch' set up to track remote branch 'test-branch' from 'origin'.
+    Switched to a new branch 'test-branch'
+
+Notez que vous pouvez vérifier le statut de votre dépôt, y compris la branche sur laquelle vous vous trouvez, à tout moment en exécutant la commande `git status`. Essayez maintenant, et git devrait vous dire quelque chose comme ceci :
+
+    On branch test-branch
     Your branch is up to date with 'origin/test-branch'.
 
-    Changes to be committed:
-      (use "git restore --staged &lt;file&gt;..." to unstage)
-        modified:   README.md</pre>
-  </li>
-  <li>
-    <p>Git nous dit que <code>README.md</code> est maintenant dans notre liste de commit. Pour inclure tous les fichiers de la liste de commit dans un commit (un seul ensemble de changements que nous essaierons plus tard d'envoyer à la branche principale), entrez ce qui suit (l'option <code>-m</code> est l'abréviation de « message ») :</p>
-    <pre class="brush: bash">git commit -m 'my first commit'</pre>
-    <p>Git vous dira ceci :</p>
-    <pre>[test-branch 44b207ef6] my first commit
-     1 file changed, 1 insertion(+), 1 deletion(-)</pre>
-    <p>Pour montrer qu'il a enregistré que vous avez fait un commit.</p>
-  </li>
-  <li>
-    <p>Exécutez <code>git status</code> à nouveau, et vous obtiendrez cette information :</p>
-    <pre>On branch test-branch
-    Your branch is ahead of 'origin/test-branch' by 1 commit.
-      (use "git push" to publish your local commits)
+    nothing to commit, working tree clean
+
+Cela semble correct. Nous sommes sur la branche "test-branch", et nous n'avons pas encore fait de changements.
+
+## Ajouter, valider et pousser les changements
+
+À ce stade, vous êtes prêt à apporter des modifications au dépôt sur lequel vous travaillez, pour corriger un bogue sur lu MDN ou autre. Nous allons sauter cette partie, car ce n'est pas le but de ce tutoriel. Si vous voulez corriger un vrai problème sur le MDN, allez choisir un bogue à corriger dans notre [liste des problèmes de contenu](https://github.com/mdn/translated-content/issues/), ou lisez [Contribuer à MDN](/fr/docs/MDN/Contribute) pour plus de conseils.
+
+Si vous voulez simplement suivre ce tutoriel à titre d'exemple, faisons quelque chose de simple.
+
+1.  Allez dans le fichier `content/README.md`, et ajoutez une seule lettre dans le titre supérieur du README.
+2.  Maintenant, retournez à votre ligne de commande et entrez à nouveau la commande `git status`. Cette fois-ci, git devrait vous dire quelque chose comme ceci :
+
+        Your branch is up to date with 'origin/test-branch'.
+
+            Changes not staged for commit:
+              (use "git add <file>..." to update what will be committed)
+              (use "git restore <file>..." to discard changes in working directory)
+                modified:   README.md
+
+            no changes added to commit (use "git add" and/or "git commit -a")
+
+3.  À ce stade, il vous indique donc les fichiers que vous avez modifiés. L'étape suivante consiste à les "ajouter", c'est-à-dire à les ajouter à une liste de fichiers que vous souhaitez commiter pour les pousser vers le fork distant. Pour ajouter ce fichier à la liste de commit, tapez ce qui suit :
+
+    ```bash
+    git add README.md
+    ```
+
+    > **Note :** `README.md` est le chemin d'accès au fichier que vous avez modifié, pas seulement son nom. S'il était à l'intérieur d'un sous-répertoire, vous auriez dû écrire le chemin complet du fichier.
+
+4.  Si vous exécutez `git status` à nouveau, vous verrez maintenant ceci :
+
+        On branch test-branch
+            Your branch is up to date with 'origin/test-branch'.
+
+            Changes to be committed:
+              (use "git restore --staged <file>..." to unstage)
+                modified:   README.md
+
+5.  Git nous dit que `README.md` est maintenant dans notre liste de commit. Pour inclure tous les fichiers de la liste de commit dans un commit (un seul ensemble de changements que nous essaierons plus tard d'envoyer à la branche principale), entrez ce qui suit (l'option `-m` est l'abréviation de « message ») :
+
+    ```bash
+    git commit -m 'my first commit'
+    ```
+
+    Git vous dira ceci :
+
+        [test-branch 44b207ef6] my first commit
+             1 file changed, 1 insertion(+), 1 deletion(-)
+
+    Pour montrer qu'il a enregistré que vous avez fait un commit.
+
+6.  Exécutez `git status` à nouveau, et vous obtiendrez cette information :
+
+        On branch test-branch
+            Your branch is ahead of 'origin/test-branch' by 1 commit.
+              (use "git push" to publish your local commits)
+
+            nothing to commit, working tree clean
+
+La lecture de l'information a fondamentalement été réinitialisée - elle nous dit qu'il n'y a pas de changements à soumettre, parce que nous avons maintenant envoyé notre changement précédent dans le système comme un commit. La principale différence par rapport à la version précédente est la ligne "Votre branche est en avance sur 'origin/test-branch' de 1 commit". - notre version locale de la branche "test-branch" est maintenant en avance sur la version distante de "test-branch" d'un commit - en d'autres termes, nous avons fait un changement localement que la branche distante n'a pas.
+
+Envoyons notre changement local à la branche distante. Vous pouvez le faire en exécutant la commande `git push` - essayez maintenant. S'il n'y a pas d'erreurs, vous devriez obtenir un affichage comme celui-ci :
+
+    Enumerating objects: 5, done.
+    Counting objects: 100% (5/5), done.
+    Delta compression using up to 8 threads
+    Compressing objects: 100% (3/3), done.
+    Writing objects: 100% (3/3), 292 bytes | 292.00 KiB/s, done.
+    Total 3 (delta 2), reused 0 (delta 0)
+    remote: Resolving deltas: 100% (2/2), completed with 2 local objects.
+    To github.com:chrisdavidmills/content.git
+        77215e31e..44b207ef6  test-branch -> test-branch
+
+## Création d'une demande de triage
+
+À ce stade, retournez sur la page github.com de votre dépôt distant. Vous devriez voir un message du type « This branch is 1 commit ahead of mdn:main. ». Ce qui signifie que le contenu de notre bifurcation contient un changement de contenu (commit) que la branche « main » de Mozilla ne contient pas.
 
-    nothing to commit, working tree clean</pre>
-  </li>
-</ol>
+1.  Pour envoyer notre modification vers la copie principale du dépôt, nous devons créer une demande de modification. Cela peut être fait facilement en utilisant le bouton "Compare & pull request" que vous devriez voir en haut de la liste des fichiers, une fois que la branche a eu une modification poussée vers elle.
 
-<p>La lecture de l'information a fondamentalement été réinitialisée - elle nous dit qu'il n'y a pas de changements à soumettre, parce que nous avons maintenant envoyé notre changement précédent dans le système comme un commit. La principale différence par rapport à la version précédente est la ligne "Votre branche est en avance sur 'origin/test-branch' de 1 commit". - notre version locale de la branche "test-branch" est maintenant en avance sur la version distante de "test-branch" d'un commit - en d'autres termes, nous avons fait un changement localement que la branche distante n'a pas.</p>
+    ![bannière avec le texte test-branch had recent pushes, et un bouton intitulé compare and pull request](compare-and-pull-request.png)
 
-<p>Envoyons notre changement local à la branche distante. Vous pouvez le faire en exécutant la commande <code>git push</code> - essayez maintenant. S'il n'y a pas d'erreurs, vous devriez obtenir un affichage comme celui-ci :</p>
+    Appuyez sur ce bouton, et vous devriez obtenir un nouvel écran qui s'affiche comme suit :
 
-<pre>Enumerating objects: 5, done.
-Counting objects: 100% (5/5), done.
-Delta compression using up to 8 threads
-Compressing objects: 100% (3/3), done.
-Writing objects: 100% (3/3), 292 bytes | 292.00 KiB/s, done.
-Total 3 (delta 2), reused 0 (delta 0)
-remote: Resolving deltas: 100% (2/2), completed with 2 local objects.
-To github.com:chrisdavidmills/content.git
-    77215e31e..44b207ef6  test-branch -> test-branch</pre>
+    ![un formulaire de demande de triage ouvert, qui comprend des champs de texte pour le titre et la description](open-pull-request.png)
 
-<h2 id="creating_a_pull_request">Création d'une demande de triage</h2>
+    > **Attention :** Ne suivez le reste de ces étapes que si vous avez une réelle modification à apporter au dépôt ! Veuillez ne pas soumettre de PR de test à nos dépôts.
 
-<p>À ce stade, retournez sur la page github.com de votre dépôt distant. Vous devriez voir un message du type « This branch is 1 commit ahead of mdn:main. ». Ce qui signifie que le contenu de notre bifurcation contient un changement de contenu (commit) que la branche « main » de Mozilla ne contient pas.</p>
+2.  À ce stade, entrez un titre et une description utiles pour votre PR, en disant exactement ce qu'il a changé, pourquoi c'est une bonne chose, et quel problème connexe il a corrigé, le cas échéant. Plus précisément, incluez une ligne disant `Fixes issue-url`. GitHub rend automatiquement cela comme un lien vers le numéro de problème, par exemple `Fixes #1234` et, en outre, ferme automatiquement le problème connexe une fois que la pull request est fusionnée.
+3.  Une fois que vous êtes prêt à envoyer votre pull request, cliquez sur le bouton « Create pull request ». Votre pull request (PR) apparaîtra alors dans la liste « [Pull requests](https://github.com/mdn/content/pulls) » du dépôt, où elle sera examinée par nos équipes de révision et, si possible, fusionnée dans le code principal.
 
-<ol>
-  <li>
-    <p>Pour envoyer notre modification vers la copie principale du dépôt, nous devons créer une demande de modification. Cela peut être fait facilement en utilisant le bouton "Compare & pull request" que vous devriez voir en haut de la liste des fichiers, une fois que la branche a eu une modification poussée vers elle.</p>
+    Si l'équipe de révision souhaite que vous apportiez des modifications, elle vous en informera dans les commentaires du fil de discussion de la demande de triage (vous devriez recevoir une notification par courriel pour vous en informer).
 
-    <p><img src="compare-and-pull-request.png" alt="bannière avec le texte test-branch had recent pushes, et un bouton intitulé compare and pull request"></p>
+4.  Si vous souhaitez apporter d'autres modifications à la même demande de dépôt que vous avez déjà soumise, vous pouvez le faire en faisant d'autres commits sur la même branche locale et en les poussant ensuite comme expliqué précédemment. Il n'est pas nécessaire de créer une demande de pull complètement nouvelle. **Veuillez simplement vous assurer que vous les faites sur la même branche que précédemment**.
 
-    <p>Appuyez sur ce bouton, et vous devriez obtenir un nouvel écran qui s'affiche comme suit :</p>
+## Dépannage
 
-    <p><img src="open-pull-request.png" alt="un formulaire de demande de triage ouvert, qui comprend des champs de texte pour le titre et la description"></p>
+Le tutoriel ci-dessus vise à vous fournir les bases de Git et de GitHub dont vous aurez besoin pour contribuer aux dépôts GitHub à un niveau de base. Nous espérons qu'il vous a été utile ! Nous aimerions également aborder le fait que, bien qu'étant le système de contrôle de version standard de l'industrie du web, Git a une sorte de réputation mythique/légendaire d'outil péniblement difficile à apprendre et à utiliser.
 
-    <div class="warning">
-      <p><strong>Attention :</strong> Ne suivez le reste de ces étapes que si vous avez une réelle modification à apporter au dépôt ! Veuillez ne pas soumettre de PR de test à nos dépôts.</p>
-    </div>
-  </li>
-  <li>
-    <p>À ce stade, entrez un titre et une description utiles pour votre PR, en disant exactement ce qu'il a changé, pourquoi c'est une bonne chose, et quel problème connexe il a corrigé, le cas échéant. Plus précisément, incluez une ligne disant <code>Fixes <em>issue-url</em></code>. GitHub rend automatiquement cela comme un lien vers le numéro de problème, par exemple <code>Fixes #1234</code> et, en outre, ferme automatiquement le problème connexe une fois que la pull request est fusionnée.</p>
-  </li>
-  <li>
-    <p>Une fois que vous êtes prêt à envoyer votre pull request, cliquez sur le bouton « Create pull request ». Votre pull request (PR) apparaîtra alors dans la liste « <a href="https://github.com/mdn/content/pulls">Pull requests</a> » du dépôt, où elle sera examinée par nos équipes de révision et, si possible, fusionnée dans le code principal.</p>
-    <p>Si l'équipe de révision souhaite que vous apportiez des modifications, elle vous en informera dans les commentaires du fil de discussion de la demande de triage (vous devriez recevoir une notification par courriel pour vous en informer).</p>
-  </li>
-  <li>
-    <p>Si vous souhaitez apporter d'autres modifications à la même demande de dépôt que vous avez déjà soumise, vous pouvez le faire en faisant d'autres commits sur la même branche locale et en les poussant ensuite comme expliqué précédemment. Il n'est pas nécessaire de créer une demande de pull complètement nouvelle. <strong>Veuillez simplement vous assurer que vous les faites sur la même branche que précédemment</strong>.</p>
-  </li>
-</ol>
+Nous ne sommes pas sûrs que ce soit tout à fait juste. Git comporte de nombreuses commandes qui sont parfois assez cryptiques dans leur utilisation, et il faut beaucoup de temps pour les maîtriser. Il est également juste de dire que si vous oubliez certaines commandes ou que vous faites les choses dans le mauvais ordre, vous pouvez vous retrouver dans un désordre intéressant dont il est difficile de se sortir. Toutefois, si vous prenez les bonnes habitudes décrites ci-dessus, vous ne devriez pas trop vous tromper. Il convient également de mentionner que Git est beaucoup plus facile à utiliser qu'il y a dix ans.
 
-<h2 id="troubleshooting">Dépannage</h2>
+Cette section sera complétée au fil du temps et comprendra des commandes/séquences utiles pour vous aider à résoudre les problèmes courants.
 
-<p>Le tutoriel ci-dessus vise à vous fournir les bases de Git et de GitHub dont vous aurez besoin pour contribuer aux dépôts GitHub à un niveau de base. Nous espérons qu'il vous a été utile ! Nous aimerions également aborder le fait que, bien qu'étant le système de contrôle de version standard de l'industrie du web, Git a une sorte de réputation mythique/légendaire d'outil péniblement difficile à apprendre et à utiliser.</p>
+### Annulation d'une modification que vous avez apportée à un fichier que vous n'avez pas encore ajouté à la liste des commits.
 
-<p>Nous ne sommes pas sûrs que ce soit tout à fait juste. Git comporte de nombreuses commandes qui sont parfois assez cryptiques dans leur utilisation, et il faut beaucoup de temps pour les maîtriser. Il est également juste de dire que si vous oubliez certaines commandes ou que vous faites les choses dans le mauvais ordre, vous pouvez vous retrouver dans un désordre intéressant dont il est difficile de se sortir. Toutefois, si vous prenez les bonnes habitudes décrites ci-dessus, vous ne devriez pas trop vous tromper. Il convient également de mentionner que Git est beaucoup plus facile à utiliser qu'il y a dix ans.</p>
+Si vous avez modifié un fichier, mais que vous n'avez pas encore exécuté la commande `git add file-path` pour l'ajouter à la liste des commits, vous pouvez revenir à l'état dans lequel il était lorsque vous avez extrait la branche pour la première fois en exécutant :
 
-<p>Cette section sera complétée au fil du temps et comprendra des commandes/séquences utiles pour vous aider à résoudre les problèmes courants.</p>
+```bash
+git restore file-path
+```
 
-<h3 id="reverting_a_change_you_made_to_a_file_that_you_havent_yet_added_to_the_commit_list">Annulation d'une modification que vous avez apportée à un fichier que vous n'avez pas encore ajouté à la liste des commits.</h3>
+### Suppression d'un fichier de la liste de commit
 
-<p>Si vous avez modifié un fichier, mais que vous n'avez pas encore exécuté la commande <code>git add <em>file-path</em></code> pour l'ajouter à la liste des commits, vous pouvez revenir à l'état dans lequel il était lorsque vous avez extrait la branche pour la première fois en exécutant :</p>
+Si vous avez déjà exécuté la commande `git add file-path` pour ajouter un fichier à la liste de commit, mais que vous voulez maintenant le supprimer de la liste de commit, vous pouvez utiliser la commande :
 
-<pre class="brush: bash">git restore <em>file-path</em></pre>
+```bash
+git restore --staged file-path
+```
 
-<h3 id="removing_a_file_from_the_commit_list">Suppression d'un fichier de la liste de commit</h3>
+### Annuler un commit
 
-<p>Si vous avez déjà exécuté la commande <code>git add <em>file-path</em></code> pour ajouter un fichier à la liste de commit, mais que vous voulez maintenant le supprimer de la liste de commit, vous pouvez utiliser la commande :</p>
+Si vous avez soumis la liste de commit en utilisant `git commit -m 'mon message de commit'`, et que vous ne l'avez pas encore poussé, mais que vous vous êtes maintenant rendu compte que vous avez mis quelque chose dedans que vous voulez enlever, vous pouvez inverser votre commit local en utilisant :
 
-<pre class="brush: bash">git restore --staged <em>file-path</em></pre>
+```bash
+git reset HEAD~1
+```
 
-<h3 id="reversing_a_commit">Annuler un commit</h3>
+Cela vous ramènera à l'état où les changements de ce commit ne sont pas encore ajoutés à la liste des commits (vous devrez les ajouter à nouveau dans git après avoir résolu le problème). Notez que cela vous ramène à l'état avant que vous ne commitiez quoi que ce soit dans cette session. Cela ne vous aidera pas si vous avez besoin de faire quelque chose de plus complexe, comme revenir sur le commit du milieu d'un ensemble de trois. Nous en resterons là pour cette leçon.
 
-<p>Si vous avez soumis la liste de commit en utilisant <code>git commit -m 'mon message de commit'</code>, et que vous ne l'avez pas encore poussé, mais que vous vous êtes maintenant rendu compte que vous avez mis quelque chose dedans que vous voulez enlever, vous pouvez inverser votre commit local en utilisant :</p>
+### Inverser un commit qui a été poussé vers la bifurcation distante
 
-<pre class="brush: bash">git reset HEAD~1</pre>
+À ce stade, il n'est pas vraiment possible de revenir en arrière, ou de rembobiner. Au lieu de cela, vous devez pousser un autre commit pour inverser les effets de celui dont vous voulez vous débarrasser. Vous pourriez le faire manuellement en utilisant certains des outils que nous vous avons déjà donnés ci-dessus, mais il y a une commande intégrée qui rend cela plus facile - `git revert`. Cela peut être utilisé pour créer automatiquement un commit qui rétablit les changements au point que vous spécifiez.
 
-<p>Cela vous ramènera à l'état où les changements de ce commit ne sont pas encore ajoutés à la liste des commits (vous devrez les ajouter à nouveau dans git après avoir résolu le problème). Notez que cela vous ramène à l'état avant que vous ne commitiez quoi que ce soit dans cette session. Cela ne vous aidera pas si vous avez besoin de faire quelque chose de plus complexe, comme revenir sur le commit du milieu d'un ensemble de trois. Nous en resterons là pour cette leçon.</p>
+1.  Dans sa forme la plus simple, vous pouvez exécuter la commande suivante pour créer un commit qui ramènera votre branche distante à l'état dans lequel vous étiez avant de commencer à soumettre le commit :
 
-<h3 id="reversing_a_commit_that_has_been_pushed_to_the_remote_fork">Inverser un commit qui a été poussé vers la bifurcation distante</h3>
+    ```bash
+    git revert HEAD
+    ```
 
-<p>À ce stade, il n'est pas vraiment possible de revenir en arrière, ou de rembobiner. Au lieu de cela, vous devez pousser un autre commit pour inverser les effets de celui dont vous voulez vous débarrasser. Vous pourriez le faire manuellement en utilisant certains des outils que nous vous avons déjà donnés ci-dessus, mais il y a une commande intégrée qui rend cela plus facile - <code>git revert</code>. Cela peut être utilisé pour créer automatiquement un commit qui rétablit les changements au point que vous spécifiez.</p>
+2.  Cela aura pour conséquence l'ouverture d'un fichier de message de commit dans votre éditeur de texte par défaut que vous devrez vérifier pour vous assurer que vous êtes satisfait. Fermez-le, et git finalisera la création du commit.
+3.  Maintenant, il faut juste le pousser :
 
-<ol>
-  <li>
-    <p>Dans sa forme la plus simple, vous pouvez exécuter la commande suivante pour créer un commit qui ramènera votre branche distante à l'état dans lequel vous étiez avant de commencer à soumettre le commit :</p>
-    <pre class="brush: bash">git revert HEAD</pre>
-  </li>
-  <li>
-    <p>Cela aura pour conséquence l'ouverture d'un fichier de message de commit dans votre éditeur de texte par défaut que vous devrez vérifier pour vous assurer que vous êtes satisfait. Fermez-le, et git finalisera la création du commit.</p>
-  </li>
-  <li>
-    <p>Maintenant, il faut juste le pousser :</p>
-    <pre class="brush: bash">git push</pre>
-  </li>
-</ol>
+    ```bash
+    git push
+    ```
 
-<p>Si vous regardez à nouveau la page github.com de votre bifurcation distante, vous verrez le commit que vous vouliez inverser, plus le commit qui l'inverse.</p>
+Si vous regardez à nouveau la page github.com de votre bifurcation distante, vous verrez le commit que vous vouliez inverser, plus le commit qui l'inverse.
 
-<div class="note">
-  <p><strong>Note :</strong> Une autre façon de se débarrasser de fichiers qui se sont retrouvés dans des demandes de triage que vous ne voulez pas voir figurer est d'utiliser l'interface utilisateur de GitHub. Allez sur la page de votre demande sur github.com, allez dans l'onglet « Files changed », et trouvez le fichier que vous voulez supprimer de la demande. En haut à droite de la boîte du fichier dans la page, il y aura un menu à « trois points » (<code>...</code>). Appuyez sur ce bouton et choisissez « Delete file ». Dans la page de confirmation, entrez un titre pour le nouveau commit, assurez-vous que la case « Commit directly... « est cochée, et appuyez sur le bouton « Commit changes ».</p>
-  <p>C'est généralement une bonne idée de faire en sorte que le reste de la demande de trisage ressemble exactement à ce que vous voulez avant de faire des changements via l'interface utilisateur de GitHub. Si vous faites quelque chose comme ça et que vous devez ensuite faire d'autres changements, vous devrez vous rappeler de tirer les changements que vous avez faits sur votre branche distante vers votre branche locale (par exemple avec <code>git pull</code>) avant de pouvoir pousser d'autres commits.</p>
-</div>
+> **Note :** Une autre façon de se débarrasser de fichiers qui se sont retrouvés dans des demandes de triage que vous ne voulez pas voir figurer est d'utiliser l'interface utilisateur de GitHub. Allez sur la page de votre demande sur github.com, allez dans l'onglet « Files changed », et trouvez le fichier que vous voulez supprimer de la demande. En haut à droite de la boîte du fichier dans la page, il y aura un menu à « trois points » (`...`). Appuyez sur ce bouton et choisissez « Delete file ». Dans la page de confirmation, entrez un titre pour le nouveau commit, assurez-vous que la case « Commit directly... « est cochée, et appuyez sur le bouton « Commit changes ».
+>
+> C'est généralement une bonne idée de faire en sorte que le reste de la demande de trisage ressemble exactement à ce que vous voulez avant de faire des changements via l'interface utilisateur de GitHub. Si vous faites quelque chose comme ça et que vous devez ensuite faire d'autres changements, vous devrez vous rappeler de tirer les changements que vous avez faits sur votre branche distante vers votre branche locale (par exemple avec `git pull`) avant de pouvoir pousser d'autres commits.
 
-<h3 id="want_to_see_more">Vous voulez en voir plus ?</h3>
+### Vous voulez en voir plus ?
 
-<p>Si vous pensez que ce guide de dépannage devrait contenir plus d'informations, veuillez <a href="https://github.com/mdn/translated-content/issues/new">créer un ticket</a> pour suggérer ce que vous pensez que nous devrions inclure.</p>