Modification de Aide:Documenter un modèle
La modification peut être annulée. Veuillez vérifier les différences ci-dessous pour voir si c’est bien ce que vous voulez faire, puis publier ces changements pour finaliser l’annulation de cette modification.
Version actuelle | Votre texte | ||
Ligne 93 : | Ligne 93 : | ||
==Suivi== | ==Suivi== | ||
Afin de suivre l'état des documentations des modèles, un [[:Catégorie:Modèle de bandeau|bandeau]] | Afin de suivre l'état des documentations des modèles, un [[:Catégorie:Modèle de bandeau|bandeau]] et un [[Poképédia:Robots|bot]] ont été créés. | ||
===Bandeau « Documentation »=== | ===Bandeau « Documentation »=== | ||
Ligne 103 : | Ligne 103 : | ||
*Le modèle est complexe et il n'y a aucun commentaire (paramètre <code>commentaire</code>). | *Le modèle est complexe et il n'y a aucun commentaire (paramètre <code>commentaire</code>). | ||
Tout le monde peut ajouter ce bandeau à un modèle ou modifier les valeurs des paramètres (<tt>oui</tt> ou <tt>non</tt>). | Tout le monde peut ajouter ce bandeau à un modèle ou modifier les valeurs des paramètres (<tt>oui</tt> ou <tt>non</tt>). | ||
===Bot : le sage Roigada=== | |||
Le bot est nommé [[Utilisateur:Roigada|Roigada]]. Il se charge uniquement des vérifications autour de la documentation des modèles. Il effectue plus précisément les vérifications suivantes : | |||
*'''Contenu de chaque page de modèle :''' présence de la balise <code><nowiki><includeonly></nowiki></code>, présence de la balise <code><nowiki><noinclude></nowiki></code> contenant uniquement <code><nowiki>{{/Documentation}}</nowiki></code> (inclusion de la sous-page de documentation), absence de tout autre texte, | |||
*'''Existence des sous-pages de documentation''', | |||
*'''Respect de la structure standard des documentations :''' présence des différentes sections, présence des catégories (et usage des balises <code><nowiki><includeonly></nowiki></code> et <code><nowiki><noinclude></nowiki></code>), le tout dans le bon ordre, | |||
*'''Paramètres du modèle :''' existence dans le modèle des paramètres documentés, paramètres du modèle tous présents dans la documentation, autant dans la section Paramètres que dans les sections Syntaxe et Exemples, | |||
*'''Présence des [[Modèle:Avertissement Modèle|avertissements spécifiques aux modèles nécessaires]]''', | |||
*'''Cohérence du bandeau de documentation :''' unicité du bandeau, existence des problèmes indiqués, | |||
*'''Présence de commentaires en cas de modèle complexe'''. | |||
Il réagit d'une façon spécifique pour chacun des cas : | |||
*'''Mauvais contenu pour une page de modèle :''' ajout ou modification du bandeau <code>[[Modèle:Documentation|<nowiki>{{Documentation}}</nowiki>]]</code>, ajout d'un message sur la page de discussion de l'utilisateur ayant réalisé la modification fautive, | |||
*'''Sous-page de documentation inexistante :''' ajout ou modification du bandeau <code>[[Modèle:Documentation|<nowiki>{{Documentation}}</nowiki>]]</code>, ajout d'un message sur la page de discussion de l'utilisateur ayant créé le modèle, | |||
*'''Non-respect de la structure standard des documentations :''' ajout ou modification du bandeau <code>[[Modèle:Documentation|<nowiki>{{Documentation}}</nowiki>]]</code>, | |||
*'''Documentation des paramètres du modèle pas à jour :''' ajout ou modification du bandeau <code>[[Modèle:Documentation|<nowiki>{{Documentation}}</nowiki>]]</code>, ajout d'un message sur la page de discussion de l'utilisateur ayant modifié les paramètres du modèle sans mettre à jour la documentation ou vice-versa, | |||
*'''Absence des avertissements pertinents ou présence d'avertissements non-pertinents :''' mise à jour du bandeau <code>[[Modèle:Avertissement Modèle|<nowiki>{{Avertissement Modèle}}</nowiki>]]</code>, | |||
*'''Bandeau de documentation incohérent :''' suppression des bandeaux doublons, mise à jour du bandeau <code>[[Modèle:Documentation|<nowiki>{{Documentation}}</nowiki>]]</code>, | |||
*'''Modèle complexe sans commentaire''' : ajout ou modification du bandeau <code>[[Modèle:Documentation|<nowiki>{{Documentation}}</nowiki>]]</code>. | |||
Roigada effectue toutes ces tâches uniquement sur les pages de l'espace de nom <tt>Modèle:</tt> et '''n'ayant pas le [[Modèle:Travail en cours|bandeau Travail en cours]]'''. | |||
==Exemples== | ==Exemples== |