Règles d'étiquettage pour MDN

  • Raccourci de la révision : Project:MDN/contribuer/Règles_d_étiquettage
  • Titre de la révision : Règles d'étiquettage pour MDN
  • ID de la révision : 442057
  • Créé :
  • Créateur : Delapouite
  • Version actuelle ? Oui
  • Commentaire added MDN tag

Contenu de la révision

Une des fonctionnalités importantes de MDN qui aide les utilisateurs à trouver du contenu sont les étiquettes. Chaque page peut être étiquettée avec aucun à plusieurs étiquettes (au moins un paraît un minimum) afin d'aider à catégoriser le contenu. Il existe de nombreuses manières pour aider à organiser l'information sur MDN. Cette page va vous aider afin de savoir étiquetter efficacement les pages afin de conserver l'organisation du contenu.

Pour un guide concernant l'interface utilisateur pour modifier les étiquettes sur les pages, référez-vous à la section étiquettage dans notre guide du contributeur.

Usage des étiquettes sur MDN

Les étiquettes sont utilisées pour différentes raisons sur MDN :

Catégorisation
Quel type de document est-ce ? Est-ce une référence ? Un tutoriel ? Une page d'accueil ?
Identification du sujet
De quel sujet cet article parle ? Est-ce à propos d'une API ? Du DOM ?
État d'avancement d'une technologie
Quel est l'avancement de la technologie ? Est-elle non standardisée ? Obsolète ou dépréciée ? Expérimentale ?
Niveau de difficulté
Pour les tutoriels et les guides, quel est le niveau de difficulté du sujet abordé par l'article ?

Guide des types d'étiquettes

Voici un guide succinct des différents types d'étiquettes existants et de valeurs possibles pour ceux-ci.

Catégorie

L'étiquettage d'un article avec une ou plusieurs des catégories suivantes facilitera la création de page d'accueil, de tables des matières. Ces termes seront aussi utilisés par notre nouveau système de recherche afin de permettre à l'utilisateur de trouver la référence ou le guide de leur choix.

Les noms de catégories suivants sont des termes standards sur MDN.

Référence
L'article est un contenu de référence à propos d'un API, d'un élément, d'un attribut, d'une propriété ou autre sujet semblable.
Accueil
Cette page est une page d'accueil.
Guide
Cet article est un guide.

Sujet

En identifiant le sujet abordé par l'article, vous aidez également à l'amélioration des résultats de recherches ainsi que la qualité des pages d'accueil et d'autres aides à la navigation.

Il existe une certaine flexibilité dans cette liste, puisque de nouveaux sujets peuvent être identifiés. Toutefois, nous tenons à ne compter dans cette liste que des noms d'APIs ou de technologies. Voici quelques exemples :

  • HTML
  • CSS
  • JavaScript (remarquez le S majuscule !)
  • Document
  • DOM
  • API (ou préférons-nous Interface Method Property ??)
  • Graphismes
  • Firefox OS
  • Gecko
  • XUL
  • XPCOM
  • SVG
  • WebGL
  • Élément
  • Node

En général, le nom d'une interface qui possède un certain nombre de pages liées, tel que Node (qui possède de nombreuses pages pour ces propriétés et méthodes) sont un bon exemple d'étiquette utile, tout comme l'est le nom d'une technologie. Une page à propos de WebGL peut être étiquettées Graphismes et WebGL par exemple, alors qu'une page à propos de {{HTMLElement("canvas")}} peut être étiquettée avec HTML, Élément, Canvas et Graphismes.

État d'avancement d'une technologie

Afin d'aider le lecteur à comprendre le niveau de maturité d'une technologie, nous utilisons les étiquettes pour mentionner le niveau d'avancement de la spécification de ladite technologie. Nous n'allons pas jusque dans le détail de la spécification et où en est-elle dans le processus (c'est le rôle du tableau des spécifications), mais cela aide le lecteur à juger en un clin d'œil s'il est raisonnable d'utiliser la technologie ou non.

Voici les valeur possibles pour ces étiquettes :

Non-standard
Indique que la technologie ou l'API décrite sur la page ne fait pas partie d'un standard, mais est considérée stable dans le ou les navigateurs qui la prenne en charge. Si cette étiquette n'est pas utilisée, il est supposé que l'article couvre un sujet standardisé. Le tableau de compatibilité sur la page doit confirmer quels navigateurs prennent en charge l'API ou la technologie.
Déprécié
La technologie ou l'API abordée sur cette page a été marqué comme déprécie dans la spécification, et il est attendu qu'elle soit un jour retirée, mais est généralement accessible pour les navigateurs actuels.
Obsolète
La technologie ou l'API a été jugé obsolète et a été retirée (ou est en cours de retrait) de tous ou la plupart des navigateurs actuels.
Expérimental
cette technologie n'est pas standardisée, et expérimentale. Elle peut devenir ou non partie d'un standard dans la futur.
Privilèges nécessaires
Cette API requiert un accès privilégié à l'appareil sur lequel le code est exécuté.
Certifié seulement
Cette API ne fonctionne qu'avec du code certifié.

Quelque soit l'utilisation de ces étiquettes, assurez-vous d'inclure un tableau de compatibilité dans votre article !

Niveau de difficulté

L'étiquette de niveau de difficulté est seulement utilisée pour les guides et tutoriels (c'est-à-dire les pages étiquettées par Guide). Ces étiquettes permettent aux lecteurs de lire des tutoriels correspondant à leur niveau de confort vis-à-vis d'une technologie. Trois valeurs existent pour ceci :

Débutant
Les articles conçus comme des introductions à la technologie pour des lecteurs n'ayant jamais utilisé ou ayant une connaissance surperficielle du sujet abordé.
Intermédiaire
Les articles conçus pour des utilisateurs ayant débuté leur utilisation de la technologie mais qui ne sont pas des experts en la matière.
Avancé
Les articles visant à approfondire les connaissances du lecteur sur un sujet donné.

En conclusion

Avec ces différentes sortes d'étiquettes, vous pouvez créer un ensemble permettant de décrire efficacement le contenu d'une page. Voici quelques exemples :

Un tutoriel à propos de WebGL pour les débutants
Les étiquettes appropriées seraient : WebGL, Graphismes, Guide, Débutant
Une page de référence pour l'élément {{HTMLElement("canvas")}}
cette page devrait avoir les étiquettes suivantes : Canvas, HTML, Élément, Graphismes, Référence
Une page d'accueil pour les outils de développement de Firefox OS
Cette page devrait être étiquettée avec Outils, Firefox OS, Accueil

Source de la révision

<p>Une des fonctionnalités importantes de MDN qui aide les utilisateurs à trouver du contenu sont les <strong>étiquettes</strong>. Chaque page peut être étiquettée avec aucun à plusieurs étiquettes (au moins un paraît un minimum) afin d'aider à catégoriser le contenu. Il existe de nombreuses manières pour aider à organiser l'information sur MDN. Cette page va vous aider afin de savoir étiquetter efficacement les pages afin de conserver l'organisation du contenu.</p>
<p>Pour un guide concernant l'interface utilisateur pour modifier les étiquettes sur les pages, référez-vous à la section <a href="/fr/docs/Project:MDN/contribuer/Comment_aider#Ajouter_ou_mettre_.C3.A0_jour_des_.C3.A9tiquettes" title="/en-US/docs/Project:MDN/Contributing/How_to_help#Add_or_update_page_tags">étiquettage</a> dans notre guide du contributeur.</p>
<h2 id="Usage_des_.C3.A9tiquettes_sur_MDN">Usage des étiquettes sur MDN</h2>
<p>Les étiquettes sont utilisées pour différentes raisons sur MDN :</p>
<dl>
  <dt>
    Catégorisation</dt>
  <dd>
    Quel type de document est-ce ? Est-ce une référence ? Un tutoriel ? Une page d'accueil ?</dd>
  <dt>
    Identification du sujet</dt>
  <dd>
    De quel sujet cet article parle ? Est-ce à propos d'une API ? Du DOM ?</dd>
  <dt>
    État d'avancement d'une technologie</dt>
  <dd>
    Quel est l'avancement de la technologie ? Est-elle non standardisée ? Obsolète ou dépréciée ? Expérimentale ?</dd>
  <dt>
    Niveau de difficulté</dt>
  <dd>
    Pour les tutoriels et les guides, quel est le niveau de difficulté du sujet abordé par l'article ?</dd>
</dl>
<h2 id="Guide_des_types_d'.C3.A9tiquettes">Guide des types d'étiquettes</h2>
<p>Voici un guide succinct des différents types d'étiquettes existants et de valeurs possibles pour ceux-ci.</p>
<h3 id="Cat.C3.A9gorie">Catégorie</h3>
<p>L'étiquettage d'un article avec une ou plusieurs des catégories suivantes facilitera la création de page d'accueil, de tables des matières. Ces termes seront aussi utilisés par notre nouveau système de recherche afin de permettre à l'utilisateur de trouver la référence ou le guide de leur choix.</p>
<p>Les noms de catégories suivants sont des termes standards sur MDN.</p>
<dl>
  <dt>
    <code>Référence</code></dt>
  <dd>
    L'article est un contenu de référence à propos d'un API, d'un élément, d'un attribut, d'une propriété ou autre sujet semblable.</dd>
  <dt>
    <code>Accueil</code></dt>
  <dd>
    Cette page est une page d'accueil.</dd>
  <dt>
    <code>Guide</code></dt>
  <dd>
    Cet article est un guide.</dd>
</dl>
<h3 id="Sujet">Sujet</h3>
<p>En identifiant le sujet abordé par l'article, vous aidez également à l'amélioration des résultats de recherches ainsi que la qualité des pages d'accueil et d'autres aides à la navigation.</p>
<p>Il existe une certaine flexibilité dans cette liste, puisque de nouveaux sujets peuvent être identifiés. Toutefois, nous tenons à ne compter dans cette liste que des noms d'APIs ou de technologies. Voici quelques exemples :</p>
<ul>
  <li><code>HTML</code></li>
  <li><code>CSS</code></li>
  <li><code>JavaScript</code> (remarquez le S majuscule !)</li>
  <li><code>Document</code></li>
  <li><code>DOM</code></li>
  <li><code>API</code> (ou préférons-nous <code>Interface</code> <code>Method</code> <code>Property </code>??)</li>
  <li><code>Graphismes</code></li>
  <li><code>Firefox OS</code></li>
  <li><code>Gecko</code></li>
  <li><code>XUL</code></li>
  <li><code>XPCOM</code></li>
  <li><code>SVG</code></li>
  <li><code>WebGL</code></li>
  <li><code>Élément</code></li>
  <li><code>Node</code></li>
</ul>
<p>En général, le nom d'une interface qui possède un certain nombre de pages liées, tel que <a href="/en-US/docs/Web/API/Node" title="/en-US/docs/Web/API/Node">Node</a> (qui possède de nombreuses pages pour ces propriétés et méthodes) sont un bon exemple d'étiquette utile, tout comme l'est le nom d'une technologie. Une page à propos de WebGL peut être étiquettées <code>Graphismes</code> et <code>WebGL</code> par exemple, alors qu'une page à propos de {{HTMLElement("canvas")}} peut être étiquettée avec <code>HTML</code>, <code>Élément</code>, <code>Canvas</code> et <code>Graphismes</code>.</p>
<h3 id=".C3.89tat_d'avancement_d'une_technologie">État d'avancement d'une technologie</h3>
<p>Afin d'aider le lecteur à comprendre le niveau de maturité d'une technologie, nous utilisons les étiquettes pour mentionner le niveau d'avancement de la spécification de ladite technologie. Nous n'allons pas jusque dans le détail de la spécification et où en est-elle dans le processus (c'est le rôle du tableau des spécifications), mais cela aide le lecteur à juger en un clin d'œil s'il est raisonnable d'utiliser la technologie ou non.</p>
<p>Voici les valeur possibles pour ces étiquettes :</p>
<dl>
  <dt>
    <code>Non-standard</code></dt>
  <dd>
    Indique que la technologie ou l'API décrite sur la page ne fait pas partie d'un standard, mais est considérée stable dans le ou les navigateurs qui la prenne en charge. Si cette étiquette n'est pas utilisée, il est supposé que l'article couvre un sujet standardisé. Le tableau de compatibilité sur la page doit confirmer quels navigateurs prennent en charge l'API ou la technologie.</dd>
  <dt>
    <code>Déprécié</code></dt>
  <dd>
    La technologie ou l'API abordée sur cette page a été marqué comme déprécie dans la spécification, et il est attendu qu'elle soit un jour retirée, mais est généralement accessible pour les navigateurs actuels.</dd>
  <dt>
    <code>Obsolète</code></dt>
  <dd>
    La technologie ou l'API a été jugé obsolète et a été retirée (ou est en cours de retrait) de tous ou la plupart des navigateurs actuels.</dd>
  <dt>
    <code>Expérimental</code></dt>
  <dd>
    cette technologie n'est pas standardisée, et expérimentale. Elle peut devenir ou non partie d'un standard dans la futur.</dd>
  <dt>
    <code>Privilèges nécessaires</code></dt>
  <dd>
    Cette API requiert un accès privilégié à l'appareil sur lequel le code est exécuté.</dd>
  <dt>
    <code>Certifié seulement</code></dt>
  <dd>
    Cette API ne fonctionne qu'avec du code certifié.</dd>
</dl>
<p>Quelque soit l'utilisation de ces étiquettes, assurez-vous d'inclure un <a href="/en-US/docs/Project:Compatibility_tables" title="/en-US/docs/Project:Compatibility_tables">tableau de compatibilité</a> dans votre article !</p>
<h3 id="Niveau_de_difficult.C3.A9">Niveau de difficulté</h3>
<p>L'étiquette de niveau de difficulté est seulement utilisée pour les guides et tutoriels (c'est-à-dire les pages étiquettées par <code>Guide</code>). Ces étiquettes permettent aux lecteurs de lire des tutoriels correspondant à leur niveau de confort vis-à-vis d'une technologie. Trois valeurs existent pour ceci :</p>
<dl>
  <dt>
    <code>Débutant</code></dt>
  <dd>
    Les articles conçus comme des introductions à la technologie pour des lecteurs n'ayant jamais utilisé ou ayant une connaissance surperficielle du sujet abordé.</dd>
  <dt>
    <code>Intermédiaire</code></dt>
  <dd>
    Les articles conçus pour des utilisateurs ayant débuté leur utilisation de la technologie mais qui ne sont pas des experts en la matière.</dd>
  <dt>
    <code>Avancé</code></dt>
  <dd>
    Les articles visant à approfondire les connaissances du lecteur sur un sujet donné.</dd>
</dl>
<h2 id="En_conclusion">En conclusion</h2>
<p>Avec ces différentes sortes d'étiquettes, vous pouvez créer un ensemble permettant de décrire efficacement le contenu d'une page. Voici quelques exemples :</p>
<dl>
  <dt>
    Un tutoriel à propos de WebGL pour les débutants</dt>
  <dd>
    Les étiquettes appropriées seraient : <code>WebGL</code>, <code>Graphismes</code>, <code>Guide</code>, <code>Débutant</code></dd>
  <dt>
    Une page de référence pour l'élément {{HTMLElement("canvas")}}</dt>
  <dd>
    cette page devrait avoir les étiquettes suivantes : <code>Canvas</code>, <code>HTML</code>, <code>Élément</code>, <code>Graphismes</code>, <code>Référence</code></dd>
  <dt>
    Une page d'accueil pour les outils de développement de Firefox OS</dt>
  <dd>
    Cette page devrait être étiquettée avec <code>Outils</code>, <code>Firefox OS</code>, <code>Accueil</code></dd>
</dl>
Revenir à cette révision