Discussion Modèle:Documentation modèle
Un article de Wikipédia, l'encyclopédie libre.
[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. |
et
|
La documentation de ce modèle est sur la page de discussion. Voir la liste des modèles. |
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)
