-
Notifications
You must be signed in to change notification settings - Fork 8.2k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Browse files
Browse the repository at this point in the history
…9006) * Adding french translation for Document_web_errors * lint correction Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> * Review / minor rewording * minor change erreurs web → erreurs javascript * JavaScript camelcase --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: SphinxKnight <[email protected]>
- Loading branch information
1 parent
61bb2fe
commit 3edea77
Showing
1 changed file
with
45 additions
and
0 deletions.
There are no files selected for viewing
45 changes: 45 additions & 0 deletions
45
files/fr/mdn/writing_guidelines/howto/document_web_errors/index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
--- | ||
title: Comment documenter les erreurs JavaScript | ||
slug: MDN/Writing_guidelines/Howto/Document_web_errors | ||
l10n: | ||
sourceCommit: 03ff2a5384ebcb8d7ae36eab7b481d8f738b71c7 | ||
--- | ||
|
||
{{MDNSidebar}} | ||
|
||
La [référence des erreurs JavaScript](/fr/docs/Web/JavaScript/Reference/Errors) sur MDN Web Docs est un projet visant à aider les développeuses et développeurs web à résoudre les erreurs survenant dans la [console web des outils de développement](https://firefox-source-docs.mozilla.org/devtools-user/web_console/index.html). Pour ce projet, nous avons besoin d'écrire plus de documentation sur les erreurs sur MDN Web Docs afin que les outils où les messages sont générés puissent renvoyer vers ces pages. Cet article explique comment documenter les erreurs JavaScript. | ||
|
||
Les erreurs JavaScript contiennent un lien « En savoir plus » qui renvoie à la référence de l'erreur JavaScript contenant des conseils supplémentaires pour résoudre les problèmes. Pour pouvoir documenter ces erreurs, vous devez connaître ou être capable de vous plonger dans le [JavaScript](/fr/docs/Web/JavaScript). | ||
|
||
> **Note :** La documentation de nouvelles erreurs doit d'abord avoir lieu en anglais avant de pouvoir traduire le nouveau contenu en français. L'organisation du contenu de MDN ne permet pas de créer du contenu en français si celui-ci n'existe pas déjà en anglais. | ||
## Étape 1 - Déterminer l'erreur à documenter | ||
|
||
- Les messages d'erreur de Firefox/Gecko : <https://github.com/mozilla/gecko-dev/blob/master/js/src/jsshell.msg> | ||
- Les messages d'erreur de Chrome/v8 : <https://chromium.googlesource.com/v8/v8.git/+/refs/heads/main/src/execution/messages.h> | ||
|
||
## Étape 2 - Vérifier la documentation existante sur l'erreur | ||
|
||
- Examinez [la page de référence des erreurs JavaScript](/fr/docs/Web/JavaScript/Reference/Errors) pour voir comment les erreurs sont documentées. | ||
- Selon le type d'erreur sur lequel vous souhaitez écrire, vous pouvez examiner de plus près ces pages. | ||
- Vous pouvez copier le contenu d'une page existante pour commencer votre nouvelle page. | ||
|
||
## Étape 3 - Créer la nouvelle page d'erreur | ||
|
||
- Toutes les pages d'erreur se trouvent sous cette arborescence : [/docs/Web/JavaScript/Reference/Errors](/fr/docs/Web/JavaScript/Reference/Errors) | ||
- Pour créer une nouvelle page (d'abord en anglais), consultez les instructions dans notre guide sur la [création de pages](/fr/docs/MDN/Writing_guidelines/Howto/Creating_moving_deleting). | ||
|
||
## Étape 4 - Documenter l'erreur | ||
|
||
- Utilisez une structure copiée à partir de l'une des pages d'erreur existantes ou commencez à partir de zéro. À vous de choisir ! | ||
- Vous devriez avoir au moins : | ||
|
||
- Une boîte de syntaxe contenant le message tel qu'il est généré dans différents navigateurs. | ||
- Le type d'erreur. | ||
- Un texte qui explique pourquoi cette erreur s'est produite et quelles sont ses conséquences. Allez au-delà du message généré. | ||
- Des exemples illustrant l'erreur (il peut y en avoir plus d'un) et un exemple montrant comment corriger le code. | ||
- Des liens vers d'autres pages de référence sur MDN Web Docs. | ||
|
||
## Étape 5 - Révision du contenu | ||
|
||
Après avoir créé la page d'erreur, soumettez-la en tant que [<i lang="en">pull request</i>](https://docs.github.com/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) sur le dépôt [`mdn/content`](https://github.com/mdn/content). Un membre de notre équipe de révision sera automatiquement désigné pour réviser votre page. |