Discussion Modèle:Documentation modèle
Un article de Wikipédia, l'encyclopédie libre.
Sommaire |
[modifier] modèle de "Documentation modèle"
- Bravo à Liné1 pour avoir fait ce que j'aurais du faire depuis longtemps
- Merci Liné1
- Bravo! pour avoir supprimé
<nowiki>:</nowiki>(il ne faut pas triturer/contourner la syntaxe wiki)
- C'était définitivement trop lourd Liné1
- la description des arguments est bien mieux que dans {{Coloré}}
- "; Paramètres" et "=valeur1" me semblent inutiles.
- Clairement la description des paramètres est le plus sujet à discussion
- j'ai retiré "----" parce que {{Documentation modèle}} me semble être une séparation suffisante. Mais bon ?
- Entièrement dac Liné1
- ... mieux vaut un (/des) exemple (sauf s'il y une catégorisation)
- Encore dac Liné1
- "facultatif" est mieux sémantiquement que "optionnel". Voir argument3
- C'est + francais, - informatique, ca me va Liné1
- je préfère "(falcultatif, défaut par défaut)" à "(falcultatif, par défaut = défaut2)" parce que
-
-
- "vierge par défaut" plutot que "défaut ="
- "argument1" n'a pas le même que "argument1".
-
- C'est + joli, ca me va Liné1
- je trouve les commentaires "NE PAS insérer de blanc ou de saut de ligne dans la ligne précédente, sinon cela fausse les résultats !" superflus. Mieux vaut se contenter d'un avertissement dans "Utilisation" ... Faut voir ?
- j'avais fait moi-même l'erreur, alors je ne sais pas si c'est superflu. ;-) Peut-être + court? Liné1
- enfin j'aimerai une recommandation sur le bonne usage de "subst:" devant "PAGENAME" :-?
- bof quand on renomme la page, on vérifie son contenu. Je ne sais pas si le subst: sert vraiment.
- reste à mettre les exemples en conformité (dès que le modèle sera accepté)
<STyx @ 12 mai 2006 à 19:27 (CEST)
- beaucoup de doc de modèle ressemble déja à ca, sauf pour les paramètres. Liné1
[modifier] gros problème
Qui fait le différence entre
 |
Ci-dessous la documentation de ce modèle. Voir la liste des modèles. Cliquez ici pour purger le cache lorsque vos modifications n’apparaissent pas. |
et
|
Ci-dessous la documentation de ce modèle. Voir la liste des modèles. Cliquez ici pour purger le cache lorsque vos modifications n’apparaissent pas. |
Cela ne saute pas au yeux. Résultat, l'on se demande pourquoi le modèle n'est pas documenté. Nombreuses remarques:
- {{Documentation modèle}} n'est pas réellement documenté (qui connaissait ce paramètre 1)
- ce paramètre 1 est idiot puisqu'il correspont à {{PAGENAME}}
- il faudrait donc plutot créer {{Modèle documenté en page de discussion}} ou {{Documentation modèle en page de discussion}}
- la documentation en page de discussion est un mauvais procédé. La page de discussion n'est pas faite pour cela !
- il faudrait de la même manière créer rapidement {{Modèle documenté en sous-page}} ou {{Documentation modèle en sous-page}} ce qui permettra d'imposer "/Documentation" en nom de sous-page.
- il faut pouvoir distinguer facilement ces modèles : couleur ou signalétique différente.
- la "documentation" actuelle serait mieux placée dans Aide:Modèle/Comment documenter un modèle ?
Je suis malheureusement trop débordé pour mettre en œuvre tout cela. <STyx @ 10 novembre 2006 à 19:40 (CET)
[modifier] Une image ad hoc et texte ad hoc
<STyx @ 5 juin 2007 à 03:15 (CEST) « Cliquez ici pour purger le cache si le modèle utilise noinclude et vos modifications n’apparaissent pas. » : il faut supprimer cette précision car
- elle alourdie le texte
- elle est erronnée ; c'est en réalité « si le modèle utilise includeonly et l'auto-inclusion »
- elle est idiote puisque « vos modifications n’apparaissent pas » => « le modèle utilise includeonly »
- elle est idiote car « il n'y a aucun empechement à purger le cache en toute circonstance »
- elle est imcompléte ; il y a des circonstances additionnelles
- (« lorsque » et mieux que « si ») il ne s'agit pas de "contrainte" mais de "circonstance"
donc mettre « Cliquez ici pour purger le cache lorsque vos modifications n’apparaissent pas. » <STyx @ 11 juin 2007 à 14:27 (CEST)
[modifier] méta modéle
- Un petit paramétrage permettra de faire de ce modèle un méta modèle pour les bandeau de documentation.
- En revanche, le paramétrage "doc en page de discussion" doit être supprimé ! <STyx @ 29 juin 2007 à 21:58 (CEST)
-
le méta-modèle en question est {{Méta documentation modèle}} <STyx @ 5 août 2007 à 19:38 (CEST)
