Modification de Discussion aide:Documenter un modèle

==Méthode de documentation "systématique" ?==
Je ne remet pas ici en cause la manière dont la documentation doit être agencée : elle est complète, informative et fait en sorte d'éviter les éditions abusives de modèles importants, notamment les infobox.<br>
Cependant, je pense que cette manière de faire ne devrait pas s'appliquer ''systématiquement'' avec certains types de modèles très simples, par exemple les [[:Catégorie:modèle de bandeau|bandeaux]] qui ne contiennent aucun paramètre à définir (en tout cas rarement plus d'un) et qui sont pour la plupart d'entre eux ''auto-descriptif''.<br>
Est-il réellement nécessaire de se plier aux exigences de ce manuel en ce qui concerne les modèles faciles à comprendre et à utiliser ? Ne pourrait-on pas rendre leur documentation moins <small>inutilement</small> épaisse ?<br>
-- [[Utilisateur:InvocK|Ίηνō¢Ќ]] [[Image:Sprite 0055 PinRS.png|x25px|link=Utilisateur:InvocK|Akwakwak est plus qu'un légendaire !!]] <sup><small>( [[Discussion utilisateur:InvocK|<font color="#A4404A">-Kẅαάκ ?-</font>]] )</small></sup> 23 juin 2011 à 20:22 (UTC)

:C'est en l'appliquant sur des modèles "simples", comme [[Modèle:Répétiteur]], que l'on se rend compte que finalement, c'est pas bien épais. Ce sera donc encore moins le cas sur des modèles sans arguments.
:[[Utilisateur:Zhuquarnage|Zhu&#39;]] 23 juin 2011 à 20:42 (UTC)

::C'est vrai, mais ça permet également de voir que certaines choses ne sont pas forcément nécessaires à chaque fois. La légende pour les icônes des paramètres n'a par exemple pas vraiment de raison d'être dans cette doc.
::En fin de compte, ne serait-il pas possible de considérer un doc comme complète même si elle ne contient pas 100% du contenu détaillé ici ?
::-- [[Utilisateur:InvocK|Ίηνō¢Ќ]] [[Image:Sprite 0055 PinRS.png|x25px|link=Utilisateur:InvocK|Akwakwak est plus qu'un légendaire !!]] <sup><small>( [[Discussion utilisateur:InvocK|<font color="#A4404A">-Kẅαάκ ?-</font>]] )</small></sup> 23 juin 2011 à 20:47 (UTC)

:::Je préfère qu'on ne fasse pas d'exception pour le moment. Je vais coder le bot de vérification en juillet, le tester, et à partir de là on verra quels ajustements seront nécessaires - en attendant, c'est plus facile pour moi de ne gérer qu'un seul type de structure.
:::--[[Utilisateur:Misdre|Misdre]] 1 juillet 2011 à 10:00 (UTC)

== Une documentation auto-évaluée?? ==

Depuis quelque temps, j'ai commencé à corriger les principaux défauts des modèles en Catégorie ''à revoir''.<br>Toutefois, j'ignore si les bots (ou utilisateurs humains) qui catégorisent comme à revoir sont en mesure de réévaluer les modèles ne fois documentés.
Je me demande donc si la documentation doit être auto-évaluée par le contributeur qui la crée ou si un bot ou un admin ou un relecteur doit repasser derrière pour vérifier que le modèle (et sa doc) est (sont) bien dans les cadres définis [[Utilisateur:DJMFan|DJMFan]] ([[Discussion utilisateur:DJMFan|discussion]]) 29 août 2016 à 22:55 (UTC).

:Salut. Je pense qu'il y a malheureusement des modèles qui sont marqués "à revoir" par des contributeurs qui ne sont pas toujours aptes à faire les modifications qu'ils ont en tête. Il suffit de voir le nombre de créations laissées en "ébauche" ou "incomplet" par les créateurs des articles... :(
:Il n'y a pas de bot vérificateur de documentation, ça reste un travail humain principalement à réaliser par le créateur (ou modificateur) du modèle concerné. Ceci-dit, toute modification de modèle ou doc effectuée par un non-relecteur est au minimum regardée par un relecteur par la suite. --[[Utilisateur:Mewtwo Ex|Mewtwo Ex]] ([[Discussion utilisateur:Mewtwo Ex|discussion]]) 29 août 2016 à 23:22 (UTC)

::Pour avoir une info de plus et rebondir sur les modèles "délaissés", ne devrait-on pas ajouter une "exception" pour le bot quand le modèle a finalement été refusé, l’intérêt de la création/de l'enrichissement de sa page de documentation étant inexistant? [[Utilisateur:DJMFan|DJMFan]] ([[Discussion utilisateur:DJMFan|discussion]]) 1 septembre 2016 à 06:32 (UTC)

:::Sauf que, comme je te l'ai dis, ça ne serait de toute façon pas très évident de faire un bot capable d'évaluer la qualité de la doc ^^' --[[Utilisateur:Mewtwo Ex|Mewtwo Ex]] ([[Discussion utilisateur:Mewtwo Ex|discussion]]) 1 septembre 2016 à 23:55 (UTC)

::::En fait dans mon idée, le bot déclassait les pages catégorisées comme Modèle refusé sans chercher à évaluer la qualité de la doc. <br><small>cela reste peut-être impossible, en ce cas, désolé de faire perdre du temps</small> [[Utilisateur:DJMFan|DJMFan]] ([[Discussion utilisateur:DJMFan|discussion]]) 2 septembre 2016 à 08:34 (UTC)

== Proposer un modèle ==

Bonjour ! J'aimerais proposer un modèle ; en venant sur cette page, je croyais pouvoir trouver ce qu'il fallait faire, mais je ne comprends pas grand-chose... Ce sont surtout les balises "includeonly" et "noinclude" qui m'intriguent, sans compter le reste de l'article... Si on pouvait me donner un exemple de modèle illustrant '''''parfaitement''''' le contenu de l'article, je serai très reconnaissant ! [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 10 juin 2017 à 17:58 (UTC)

:Voir [[Aide:Modèle]]. Le but de la page [[Aide:Documenter un modèle]] est d'expliquer comment rédiger une page d'explication du fonctionnement du modèle. --[[Utilisateur:Mewtwo Ex|Mewtwo Ex]] ([[Discussion utilisateur:Mewtwo Ex|discussion]]) 10 juin 2017 à 18:40 (UTC)

::Ça fait un moment que j'étudie le sujet, et je peine à comprendre... Si vous voulez que je puisse proposer un nouveau modèle, laissez-moi du temps, SVP. [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 13 juin 2017 à 17:32 (UTC)

:::Après une étude régulière <small>et forcée</small>, je pense peut-être avoir (enfin) compris l'intérêt de la balise "noinclude" : elle servirait à pouvoir écire un texte sans qu'il ne soit inclus ''dans'' un modèle, de manière à ce que le texte n'apparaisse pas lorsqu'on utilise le modèle, c'est ça ? Par contre, je bloque encore sur la fonction de la balise "includeonly"... [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 17 juin 2017 à 13:40 (UTC)

::::C'est ça, quant à la balise "includeonly", c'est l'inverse : le texte n'apparaît pas sur la page du modèle, il apparaît seulement quand le modèle est utilisé. --[[Utilisateur:X-Fusion|XFusio]] ([[Discussion utilisateur:X-Fusion|discussion]]) 17 juin 2017 à 20:43 (UTC)

:::::Ok, j'en prends note ! J'ai vraiment été long à comprendre ça... Mais bon, je n'ai plus qu'à commencer ! [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 17 juin 2017 à 21:44 (UTC)

::::::Est-ce que les balises "noinclude" et "includeonly" sont obligatoires ? [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 18 juin 2017 à 09:23 (UTC)

:::::::Sur le principe non, mais en pratique il y aura toujours quelque chose à mettre dans un noinclude au minimum : le lien vers la doc du modèle. --[[Utilisateur:Mewtwo Ex|Mewtwo Ex]] ([[Discussion utilisateur:Mewtwo Ex|discussion]]) 18 juin 2017 à 21:45 (UTC)

::::::::Ce qui donne <code><nowiki><noinclude>[[Modèle:NomDuModèle/Documentation]]</noinclude></nowiki></code> ? [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 19 juin 2017 à 15:54 (UTC)

::::::::Pour le principe, je vais essayer de répondre de la manière la plus concise et explicative possible : lorsque l'on crée un modèle, le premier code à taper est :<br> <nowiki>{{/Documentation}}</nowiki> ce qui crée automatiquement un lien vers la page de documentation du modèle. Le balisage <nowiki><noinclude></noinclude></nowiki> permet de faire en sorte que chaque appel au modèle n'affiche pas avec la documentation <small>(ce qui, entre nous, serait assez embêtant surtout pour les infobox)</small>.<br>Le balisage "includeonly" autour du code du modèle permet quant à lui de n'afficher que la documentation sur la page du modèle, permettant aux contributeurs débutants ou expérimentés d'avoir un accès simple et rapide à cette documentation.<br>En fait, le balisage permet surtout deux choses :
:::::::#Ne pas faire apparaître le code du modèle (trop souvent complexe et pas à jour)
:::::::#Donner un accès simplifié aux informations d'utilisation sans perturber ladite utilisation.
Dans tous les cas, avant d'être accepté, un modèle doit être discuté, moyennant quoi il est toujours possible de l'expliciter sur la page <nowiki>[[Discussion Modèle:NomDuModèle]]</nowiki>.<br>Au passage, et si le besoin s'en fait sentir, on peut toujours trouver de la doc' (si on a la patience) sur les balises (parce que oui, il y en a (beaucoup) d'autres) en cherchant sur le wiki du mediawiki <small>wikiception</small>.<br>Sinon, maintenant que je commence à piger le truc, je peux filer un coup de main à ceux qui le veulent.<br> [[Utilisateur:DJMFan|DJMFan]] ([[Discussion utilisateur:DJMFan|discussion]]) 19 juin 2017 à 20:33 (UTC)<small>qui espère qu'il a plus aidé qu'embrouillé</small>.

:C'est donc censé être [[Utilisateur:Évolimiqui/Bac à sable#Ébauche : Modèle:Utilisateur récent|comme ça]], si on ne compte pas les balises "nowiki" ? [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 20 juin 2017 à 16:28 (UTC)

::Presque, par convention, on a décidé que sur Poképédia, les pages du modèle ne contiendraient que le code, donc la catégorie se trouve sur la page de documentation entre balises "includeonly". Dans ton cas, cela donne :

::<nowiki><noinclude>{{/Documentation}}</noinclude><includeonly>Ton modèle et son code</includeonly></nowiki>

::<nowiki>Sur la page de doc', la conclusion est<includeonly>[[Catégorie:Modèle pour utilisateur]]</includeonly> <noinclude>[[Catégorie:Aide de modèle]]</noinclude></nowiki> [[Utilisateur:DJMFan|DJMFan]] ([[Discussion utilisateur:DJMFan|discussion]]) 20 juin 2017 à 18:58 (UTC)

:::Merci ! Je touche au but ! J'y suis presque ! [[Fichier:Miniature 133 XY.png]] '''[[Utilisateur:Évolimiqui|<span style="color:#ADA594">Évoli</span>]][[Discussion utilisateur:Évolimiqui|<span style="color:#6363B5">mi</span><span style="color:#E09AE3">qui</span>]]''' [[Fichier:Miniature 0778 SL.png]] 21 juin 2017 à 16:09 (UTC)