From 9ffc5439cab71314e607077b3fae3b385b2f1560 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Tue, 26 Mar 2024 22:51:55 +0100 Subject: [PATCH 01/16] Adding french translation for Document_an_HTTP_header --- .../howto/document_an_http_header/index.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md new file mode 100644 index 00000000000000..107649a6955ef4 --- /dev/null +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -0,0 +1,55 @@ +--- +title: Comment documenter un en-tête HTTP +slug: MDN/Writing_guidelines/Howto/Document_an_HTTP_header +--- + +{{MDNSidebar}} + +La [référence des en-têtes HTTP](/fr/docs/Web/HTTP/Headers) sur MDN Web Docs documente les champs d'en-têtes HTTP. Ce sont des composants de la section d'en-tête des messages de requête et de réponse dans le protocole de transfert hypertexte ([HTTP](/fr/docs/Web/HTTP)). Ils définissent les paramètres de fonctionnement d'une transaction HTTP. Cet article explique comment créer une nouvelle page de référence pour un en-tête HTTP. + +Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt à vous familiariser avec ses détails. + +## Étape 1 - Déterminer l'en-tête HTTP à documenter + +- De nombreux en-têtes HTTP sont définis dans diverses normes de l'IETF. +- L'IANA tient un [registre des champs d'en-tête HTTP](https://www.iana.org/assignments/http-fields/http-fields.xhtml) et Wikipédia répertorie [les champs d'en-tête connus](https://en.wikipedia.org/wiki/List_of_HTTP_header_fields), mais tous ne sont pas pertinents pour les développeurs web ou ne font pas partie d'une norme officielle. +- S'il existe des **liens rouges** sur la page de [référence des en-têtes HTTP](/fr/docs/Web/HTTP/Headers), ces en-têtes sont un bon choix à documenter. +- En cas de doute, [demandez à l'équipe de MDN Web Docs](/en-US/docs/MDN/Community/Communication_channels) s'il est judicieux d'écrire sur l'en-tête que vous avez choisi. + +## Étape 2 - Vérifier les pages d'en-tête HTTP existantes + +- Les en-têtes HTTP existants sont documentés [ici](/fr/docs/Web/HTTP/Headers). +- Il existe différentes catégories d'en-têtes : {{Glossary("Request header","En-tête de requête")}}, {{Glossary("Response header","En-tête de réponse")}}, et {{Glossary("Representation header","En-tête de représentation")}}. +- Trouvez la catégorie de l'en-tête que vous vous apprêtez à documenter (notez que certains en-têtes peuvent être à la fois des en-têtes de demande et des en-têtes de réponse, selon le contexte). +- Accédez à une page de référence d'en-tête existant dans la même catégorie. + +## Étape 3 - Créer la page d'en-tête HTTP + +- Toutes les pages d'en-tête se trouvent sous cette arborescence : [/docs/Web/HTTP/Headers/](/fr/docs/Web/HTTP/Headers) +- Pour créer une nouvelle page, voir les instructions dans notre [guide de création de pages](/fr/docs/MDN/Writing_guidelines/Howto/Creating_moving_deleting). + +## Étape 4 - Rédiger le contenu + +- Vous pouvez soit partir de notre [modèle de page d'en-tête HTTP](/en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types#http_header_reference_page), soit utiliser une structure copiée à partir de l'un des documents d'en-tête HTTP existants que vous avez trouvés à l'étape 2. C'est à vous de choisir. +- Rédigez un texte sur le nouvel en-tête HTTP. +- Assurez-vous d'avoir les sections suivantes : + - Texte d'introduction dont la première phrase mentionne le nom de l'en-tête (en gras) et résume son objectif. + - Une boîte d'information contenant au moins le type d'en-tête et si l'en-tête est un {{Glossary("Forbidden header name","nom d'en-tête interdit")}}. + - Un encart syntaxique contenant toutes les directives/paramètres/valeurs possibles de l'en-tête HTTP. + - Une section expliquant ces directives/valeurs. + - Une section d'exemples qui contient un cas d'utilisation pratique pour cet en-tête ou qui montre où et comment il se produit habituellement. + - Une section de spécification listant les documents standards RFC pertinents. + - Une section "Voir aussi" énumérant les ressources pertinentes. + +## Étape 5 - Ajouter des informations sur la compatibilité des navigateurs + +- Si vous avez consulté d'autres pages d'en-tête HTTP, vous verrez qu'il existe une macro `{{Compat}}` qui remplit une table du navigateur pour vous. +- La page du tableau de compatibilité est générée à partir de données structurées. Si vous souhaitez contribuer à ces données, veuillez consulter les instructions à l'adresse et nous envoyer une Pull Request. + +## Étape 6 - Mise à jour de la liste des en-têtes HTTP + +Assurez-vous que votre en-tête est répertorié dans une catégorie appropriée sur la [page de référence des en-têtes HTTP](/fr/docs/Web/HTTP/Headers). + +## Étape 7 - Révision du contenu + +Après avoir créé la page d'en-tête, soumettez-la en tant que Pull Request. Un membre de notre équipe de révision sera automatiquement désigné pour réviser votre page. From bc65dabcfd108b76cefa7bafdeb370ec2896acb2 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Tue, 26 Mar 2024 22:58:46 +0100 Subject: [PATCH 02/16] mdn-lint correction - space Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index 107649a6955ef4..de5f4af61f1f05 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -34,7 +34,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt - Rédigez un texte sur le nouvel en-tête HTTP. - Assurez-vous d'avoir les sections suivantes : - Texte d'introduction dont la première phrase mentionne le nom de l'en-tête (en gras) et résume son objectif. - - Une boîte d'information contenant au moins le type d'en-tête et si l'en-tête est un {{Glossary("Forbidden header name","nom d'en-tête interdit")}}. + - Une boîte d'information contenant au moins le type d'en-tête et si l'en-tête est un {{Glossary("Forbidden header name","nom d'en-tête interdit")}}. - Un encart syntaxique contenant toutes les directives/paramètres/valeurs possibles de l'en-tête HTTP. - Une section expliquant ces directives/valeurs. - Une section d'exemples qui contient un cas d'utilisation pratique pour cet en-tête ou qui montre où et comment il se produit habituellement. From 09f3104f5eeafbed26694c09f973d748722c9b1a Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 27 Mar 2024 09:34:17 +0100 Subject: [PATCH 03/16] en-us link to fr Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index de5f4af61f1f05..dfa5642beacdf5 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -14,7 +14,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt - De nombreux en-têtes HTTP sont définis dans diverses normes de l'IETF. - L'IANA tient un [registre des champs d'en-tête HTTP](https://www.iana.org/assignments/http-fields/http-fields.xhtml) et Wikipédia répertorie [les champs d'en-tête connus](https://en.wikipedia.org/wiki/List_of_HTTP_header_fields), mais tous ne sont pas pertinents pour les développeurs web ou ne font pas partie d'une norme officielle. - S'il existe des **liens rouges** sur la page de [référence des en-têtes HTTP](/fr/docs/Web/HTTP/Headers), ces en-têtes sont un bon choix à documenter. -- En cas de doute, [demandez à l'équipe de MDN Web Docs](/en-US/docs/MDN/Community/Communication_channels) s'il est judicieux d'écrire sur l'en-tête que vous avez choisi. +- En cas de doute, [demandez à l'équipe de MDN Web Docs](/fr/docs/MDN/Community/Communication_channels) s'il est judicieux d'écrire sur l'en-tête que vous avez choisi. ## Étape 2 - Vérifier les pages d'en-tête HTTP existantes From 230c44a2e6e6f692480c2dcf847058ab46315891 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 27 Mar 2024 09:34:32 +0100 Subject: [PATCH 04/16] en-us link to fr Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index dfa5642beacdf5..c3706ff0ca0ece 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -30,7 +30,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt ## Étape 4 - Rédiger le contenu -- Vous pouvez soit partir de notre [modèle de page d'en-tête HTTP](/en-US/docs/MDN/Writing_guidelines/Page_structures/Page_types#http_header_reference_page), soit utiliser une structure copiée à partir de l'un des documents d'en-tête HTTP existants que vous avez trouvés à l'étape 2. C'est à vous de choisir. +- Vous pouvez soit partir de notre [modèle de page d'en-tête HTTP](/fr/docs/MDN/Writing_guidelines/Page_structures/Page_types#http_header_reference_page), soit utiliser une structure copiée à partir de l'un des documents d'en-tête HTTP existants que vous avez trouvés à l'étape 2. C'est à vous de choisir. - Rédigez un texte sur le nouvel en-tête HTTP. - Assurez-vous d'avoir les sections suivantes : - Texte d'introduction dont la première phrase mentionne le nom de l'en-tête (en gras) et résume son objectif. From 928246cf79a2324a3952015dae2c80bf8039746a Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 27 Mar 2024 14:32:53 +0100 Subject: [PATCH 05/16] Adding link for Pull Request --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index c3706ff0ca0ece..b202dd61982f58 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -52,4 +52,4 @@ Assurez-vous que votre en-tête est répertorié dans une catégorie appropriée ## Étape 7 - Révision du contenu -Après avoir créé la page d'en-tête, soumettez-la en tant que Pull Request. Un membre de notre équipe de révision sera automatiquement désigné pour réviser votre page. +Après avoir créé la page d'en-tête, soumettez-la en tant que [Pull Request](https://docs.github.com/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). Un membre de notre équipe de révision sera automatiquement désigné pour réviser votre page. From c24b8d32cf0a13c4116967dd0b34408ff6fa2009 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:10:35 +0200 Subject: [PATCH 06/16] change: adding l10n:sourceCommit metadata --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index b202dd61982f58..66916865bc88f0 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -1,6 +1,8 @@ --- title: Comment documenter un en-tête HTTP slug: MDN/Writing_guidelines/Howto/Document_an_HTTP_header +l10n: + sourceCommit: 17db3c03142f7077dc335f6f7c127388e2c64442 --- {{MDNSidebar}} From 0ef4506d24853250b72a97b53711a14d8da8e29d Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:11:57 +0200 Subject: [PATCH 07/16] change: Adding note - english before french --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index 66916865bc88f0..f16ba5c0e39081 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -11,6 +11,8 @@ La [référence des en-têtes HTTP](/fr/docs/Web/HTTP/Headers) sur MDN Web Docs Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt à vous familiariser avec ses détails. +> **Note :** La documentation de nouvelles en-têtes HTTP 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'en-tête HTTP à documenter - De nombreux en-têtes HTTP sont définis dans diverses normes de l'IETF. From 40bf67793267e71c75af82fd7a8f8b61e8845261 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:15:22 +0200 Subject: [PATCH 08/16] Update files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md Co-authored-by: SphinxKnight --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index f16ba5c0e39081..e7153315df3321 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -16,7 +16,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt ## Étape 1 - Déterminer l'en-tête HTTP à documenter - De nombreux en-têtes HTTP sont définis dans diverses normes de l'IETF. -- L'IANA tient un [registre des champs d'en-tête HTTP](https://www.iana.org/assignments/http-fields/http-fields.xhtml) et Wikipédia répertorie [les champs d'en-tête connus](https://en.wikipedia.org/wiki/List_of_HTTP_header_fields), mais tous ne sont pas pertinents pour les développeurs web ou ne font pas partie d'une norme officielle. +- L'IANA tient un [registre des champs d'en-tête HTTP](https://www.iana.org/assignments/http-fields/http-fields.xhtml) et Wikipédia répertorie [les champs d'en-tête connus](https://en.wikipedia.org/wiki/List_of_HTTP_header_fields), mais tous ne sont pas pertinents pour les développeuses et développeurs web ou ne font pas partie d'une norme officielle. - S'il existe des **liens rouges** sur la page de [référence des en-têtes HTTP](/fr/docs/Web/HTTP/Headers), ces en-têtes sont un bon choix à documenter. - En cas de doute, [demandez à l'équipe de MDN Web Docs](/fr/docs/MDN/Community/Communication_channels) s'il est judicieux d'écrire sur l'en-tête que vous avez choisi. From 448a8a9622123049e9bd7530cdc19fdeee60d831 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:18:47 +0200 Subject: [PATCH 09/16] change: link instead of macros --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index e7153315df3321..476c4f22880db8 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -23,7 +23,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt ## Étape 2 - Vérifier les pages d'en-tête HTTP existantes - Les en-têtes HTTP existants sont documentés [ici](/fr/docs/Web/HTTP/Headers). -- Il existe différentes catégories d'en-têtes : {{Glossary("Request header","En-tête de requête")}}, {{Glossary("Response header","En-tête de réponse")}}, et {{Glossary("Representation header","En-tête de représentation")}}. +- Il existe différentes catégories d'en-têtes : [en-tête de requête](/fr/docs/Glossary/Request_header), [en-tête de réponse](/en-US/docs/Glossary/Response_header), et [en-tête de représentation](/fr/docs/Glossary/Representation_header). - Trouvez la catégorie de l'en-tête que vous vous apprêtez à documenter (notez que certains en-têtes peuvent être à la fois des en-têtes de demande et des en-têtes de réponse, selon le contexte). - Accédez à une page de référence d'en-tête existant dans la même catégorie. From e13306eaa2342f7cc704e651fbd90d52bad2128d Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:20:23 +0200 Subject: [PATCH 10/16] =?UTF-8?q?change:=20"requ=C3=AAte"=20instead=20of?= =?UTF-8?q?=20"demande"?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index 476c4f22880db8..78c8ee73a77704 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -24,7 +24,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt - Les en-têtes HTTP existants sont documentés [ici](/fr/docs/Web/HTTP/Headers). - Il existe différentes catégories d'en-têtes : [en-tête de requête](/fr/docs/Glossary/Request_header), [en-tête de réponse](/en-US/docs/Glossary/Response_header), et [en-tête de représentation](/fr/docs/Glossary/Representation_header). -- Trouvez la catégorie de l'en-tête que vous vous apprêtez à documenter (notez que certains en-têtes peuvent être à la fois des en-têtes de demande et des en-têtes de réponse, selon le contexte). +- Trouvez la catégorie de l'en-tête que vous vous apprêtez à documenter (notez que certains en-têtes peuvent être à la fois des en-têtes de requête et des en-têtes de réponse, selon le contexte). - Accédez à une page de référence d'en-tête existant dans la même catégorie. ## Étape 3 - Créer la page d'en-tête HTTP From be07308d0f6a8577c247429b3ccc80f6df85f32f Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:22:12 +0200 Subject: [PATCH 11/16] change: Adding non-breaking space --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index 78c8ee73a77704..72ac56ffd456ec 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -29,7 +29,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt ## Étape 3 - Créer la page d'en-tête HTTP -- Toutes les pages d'en-tête se trouvent sous cette arborescence : [/docs/Web/HTTP/Headers/](/fr/docs/Web/HTTP/Headers) +- Toutes les pages d'en-tête se trouvent sous cette arborescence : [/docs/Web/HTTP/Headers/](/fr/docs/Web/HTTP/Headers) - Pour créer une nouvelle page, voir les instructions dans notre [guide de création de pages](/fr/docs/MDN/Writing_guidelines/Howto/Creating_moving_deleting). ## Étape 4 - Rédiger le contenu From ae128ac489a8dedd405f24c96515cdba058b6560 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:23:05 +0200 Subject: [PATCH 12/16] change: Adding non-breaking space --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index 72ac56ffd456ec..f2436a770b8074 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -36,7 +36,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt - Vous pouvez soit partir de notre [modèle de page d'en-tête HTTP](/fr/docs/MDN/Writing_guidelines/Page_structures/Page_types#http_header_reference_page), soit utiliser une structure copiée à partir de l'un des documents d'en-tête HTTP existants que vous avez trouvés à l'étape 2. C'est à vous de choisir. - Rédigez un texte sur le nouvel en-tête HTTP. -- Assurez-vous d'avoir les sections suivantes : +- Assurez-vous d'avoir les sections suivantes : - Texte d'introduction dont la première phrase mentionne le nom de l'en-tête (en gras) et résume son objectif. - Une boîte d'information contenant au moins le type d'en-tête et si l'en-tête est un {{Glossary("Forbidden header name","nom d'en-tête interdit")}}. - Un encart syntaxique contenant toutes les directives/paramètres/valeurs possibles de l'en-tête HTTP. From bdf95753b062d4720579452c45d9eeec48a7d4f9 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:24:24 +0200 Subject: [PATCH 13/16] change: link instead of macros --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index f2436a770b8074..27cb46ae9693a0 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -38,7 +38,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt - Rédigez un texte sur le nouvel en-tête HTTP. - Assurez-vous d'avoir les sections suivantes : - Texte d'introduction dont la première phrase mentionne le nom de l'en-tête (en gras) et résume son objectif. - - Une boîte d'information contenant au moins le type d'en-tête et si l'en-tête est un {{Glossary("Forbidden header name","nom d'en-tête interdit")}}. + - - Une boîte d'information contenant au moins le type d'en-tête et si l'en-tête est un [nom d'en-tête interdit](/fr/docs/Glossary/Forbidden_header_name). - Un encart syntaxique contenant toutes les directives/paramètres/valeurs possibles de l'en-tête HTTP. - Une section expliquant ces directives/valeurs. - Une section d'exemples qui contient un cas d'utilisation pratique pour cet en-tête ou qui montre où et comment il se produit habituellement. From 1d239eca658cff3977dab471a78ea5b06c6c99d4 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:25:34 +0200 Subject: [PATCH 14/16] change: adding lang i tag --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index 27cb46ae9693a0..fc53b4003af4d2 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -48,7 +48,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt ## Étape 5 - Ajouter des informations sur la compatibilité des navigateurs - Si vous avez consulté d'autres pages d'en-tête HTTP, vous verrez qu'il existe une macro `{{Compat}}` qui remplit une table du navigateur pour vous. -- La page du tableau de compatibilité est générée à partir de données structurées. Si vous souhaitez contribuer à ces données, veuillez consulter les instructions à l'adresse et nous envoyer une Pull Request. +- La page du tableau de compatibilité est générée à partir de données structurées. Si vous souhaitez contribuer à ces données, veuillez consulter les instructions à l'adresse et nous envoyer une pull request. ## Étape 6 - Mise à jour de la liste des en-têtes HTTP From 2f55f5ab614f46073ffaf0eb5490ed9a803099d1 Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:26:18 +0200 Subject: [PATCH 15/16] change: "pull request" instead of "Pull Request" --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index fc53b4003af4d2..a3e4e4e711fd50 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -56,4 +56,4 @@ Assurez-vous que votre en-tête est répertorié dans une catégorie appropriée ## Étape 7 - Révision du contenu -Après avoir créé la page d'en-tête, soumettez-la en tant que [Pull Request](https://docs.github.com/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). Un membre de notre équipe de révision sera automatiquement désigné pour réviser votre page. +Après avoir créé la page d'en-tête, soumettez-la en tant que [pull request](https://docs.github.com/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request). Un membre de notre équipe de révision sera automatiquement désigné pour réviser votre page. From bfe1fa5c953072d4bf787cd105627b23c0cc253b Mon Sep 17 00:00:00 2001 From: Quentin <59255702+quentin-rey@users.noreply.github.com> Date: Wed, 10 Apr 2024 17:30:59 +0200 Subject: [PATCH 16/16] Update files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- .../writing_guidelines/howto/document_an_http_header/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md index a3e4e4e711fd50..e1934ca4adeb69 100644 --- a/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md +++ b/files/fr/mdn/writing_guidelines/howto/document_an_http_header/index.md @@ -23,7 +23,7 @@ Vous devrez avoir des connaissances en [HTTP](/fr/docs/Web/HTTP) ou être prêt ## Étape 2 - Vérifier les pages d'en-tête HTTP existantes - Les en-têtes HTTP existants sont documentés [ici](/fr/docs/Web/HTTP/Headers). -- Il existe différentes catégories d'en-têtes : [en-tête de requête](/fr/docs/Glossary/Request_header), [en-tête de réponse](/en-US/docs/Glossary/Response_header), et [en-tête de représentation](/fr/docs/Glossary/Representation_header). +- Il existe différentes catégories d'en-têtes : [en-tête de requête](/fr/docs/Glossary/Request_header), [en-tête de réponse](/fr/docs/Glossary/Response_header), et [en-tête de représentation](/fr/docs/Glossary/Representation_header). - Trouvez la catégorie de l'en-tête que vous vous apprêtez à documenter (notez que certains en-têtes peuvent être à la fois des en-têtes de requête et des en-têtes de réponse, selon le contexte). - Accédez à une page de référence d'en-tête existant dans la même catégorie.