Consignes de rédaction du WikiThelia
Bienvenue !
L'objectif de cette page est de récapituler les bonnes méthodes pour les éditeurs et les volontaires du WikiThelia. Si vous avez des idées pour l'améliorer, n'hésitez pas, ces règles sont inspirées de celles utilisées sur le Codex WordPress.
Règles générales
- Soyez agréable - Pas d'attaque personnelle ou de comportement violent. Restez professionnel, poli et patient.
- Diffusez l'information à bon escient, vite et régulièrement.
- Modifiez sans état d'âme.
- En cas de doute, DEMANDEZ.
- Amusez-vous. :)
Méthodes standards
Nouvelles Pages
Les nouveaux articles et les nouvelles pages sont les bienvenu(e)s. Cependant, il y a une procédure à suivre:
Si vous n'êtes pas inscrit, suivez les instructions : Contribuez: Chaque Chose en son Temps.
Si l'article est assez complet, ajoutez-le comme une nouvelle page. Voir : Créer une Nouvelle Page.
Si l'article est incomplet ou un brouillon, ajoutez-le comme sous-page de votre propre page utilisateur. Voir : Créer une Page Utilisateur.
Merci de suivre les règles de style pour les articles du Codex qui sont établies ici : Styles du WikiThelia.
Consignes pour les nouvelles contributions au Codex:
- Si vous écrivez un article ressemblant à un article existant, améliorez la page existante.
- Ajoutez un lien entre un article existant et le votre pour développer les connexions entre les pages. Ne créez pas de page "cul-de-sac"; ce sont des pages sans lien vers d'autres pages du Codex.
- Une fois les pages créées, elle sont actives et les liens pointant vers elle fonctionneront. Si les utilisateurs tombent sur une page vide, ils ont perdu leur temps. Créez les pages seulement quand vous avez un contenu suffisamment complet pour les remplir.
- Une fois votre page complétée et déplacée de vos pages personnelles à la documentation, les liens doivent être placés dans une rubrique de la table des matières et dans les autres documents en relation avec la nouvelle page. Demandez conseil si vous n'êtes pas sûr de l'endroit où placer un lien dans la table des matières. Ne placez pas de liens sur la page d'accueil sans demander.
Utilisez les raccourcis suivants pour classer l'article en fonction de son état :
- {{Stub}}
La catégorie Stub désigne une page incomplète qu'il faut éditer et étendre.
- {{Draft}}
A placer en début de page. Toutes les pages ajoutées sont indexées par des moteurs de recherche. L'indicateur Draft (brouillon) en début de page avertira les utilisateurs qu'il s'agit d'un travail inachevé en cours de réalisation, et que les informations peuvent ne pas être correctes. Cela permet aussi d'avertir les autres de ne pas éditer cette page tant que vous n'avez pas fini de travailler dessus.
- [[Category:New page created]]
Permet de définir la page comme nouvelle et d'attirer l'attention des éditeurs. Ne l'utilisez que lorsque vous êtes prêt à ce que le contenu soit modifié et/ou que la page soit déplacée dans la documentation générale depuis votre page personnelle.
- {{Copyedit}}
Copyedit permet de marquer les articles qui ont besoin d'être retravaillés. Ces articles sont assez complets mais ont besoin d'être repris. Utilisez {{Stub}} pour les articles incomplets.
Titres
Les titres pour les nouvelles pages doivent commencer par des Majuscules à Chaque Mot.
Tous les titres de section doivent être mis en forme de la sorte. Par exemple, utilisez "Utilisez le Gestionnaire de Liens" plutot que "Utilisez le gestionnaire de lien". Ce sont des titres complets. Ne pas utilisez "IntroAuxBlogs" mais "Introduction aux Blogs".
Les titres doivent suivre également les règles de Dr. Grammar concernant la mise en majuscules : "Dans les titres, mettre en majuscule la première lettre du premier mot, du dernier et tous les autres mots à l'exception des articles (un, le,...), les préposition de moins de 5 lettres et les conjonctions de coordination. Cette règle s'applique aux titres longs et courts aussi bien pour vos travaux partiels que pour vos publications" (Anson, Schwegler, and Muth. the Longman Writer's Companion 240)
- Les titres doivent autant que possible être orientés vers des actions ou des taches. Ainsi "Utiliser le Gestionnaire de Liens" est préférable à "Le Gestionnaire de Liens". Quels mots-clés seront utilisés lors de la recherche de cette information ?
- Les titres ne doivent pas contenir d'espaces inutiles que ce soit en début, en fin ou entre les mots. Essayez aussi d'éviter les symboles tels que "-", "#", "?" et "+".
- Les titres courts sont préférés.
- Merci d'éviter autant que possible les prépositions dans les titres.
- En cas de doute concernant la convenance d'un nom, demandez pour avoir une suggestion.
- N'utilisez pas la syntaxe CamelCase pour les titres des pages : Le WikiThelia n'utilise pas le Camel Case comme le font certains wiki. Toutes les pages et par conséquent tous les liens doivent utilisez la syntaxe normale des titres. Par exemple, le page anglaise concernant le Codex porte le titre "About Codex", avec comme lien: [[About Codex]] et non pas la syntaxe CamelCase [[AboutCodex]].
Sous-pages
Ne créez pas d'autres sous-pages, que celles sous votre page utilisateur sans demander avant. Exemple : Vous pouvez créer la sous-page : User:votre user/Page_Exemple par contre ne créez pas de sous-page Main_Page/Page_Exemple.
Discussions
Utilisez les pages de "Discussion"
Vous avez remarqué quelque chose qui vous semble incorrect ou nécessitant une clarification? La meilleur façon d'en faire mention est d'utiliser la fonction DISCUSSION. Abstenez-vous svp d'ajouter vos commentaires directement dans l'ARTICLE. Il y a au sommet de chaque page un onglet DISCUSSION. C'est l'endroit prévu pour faire vos commentaires, suggestions ou autres. Merci!
- Laisser un message à propos d'un article : Pour laisser un message en rapport avec un article, cliquez sur l'onglet Discussion de l'article et déposez votre message en le signant.
- Laisser un message pour un utilisateur : Laissez un message à un utilisateur en modifiant la page User:Talk de l'utilisateur. N'oubliez pas de signer vos commentaires. L'utilisateur recevra un signal visuel à sa prochaine connexion au WikiThelia.
- Séparer les commentaires : Merci de placer une ligne horizontale entre chaque commentaire sur les pages de discussion en utilisant 4 tirets ----. Si vous débutez un nouveau sujet de conversation, utilisez le lien "+" à côté du lien "éditer", afin de créer une nouvelle section.
- Signez toujours vos commentaires : Pour ajouter votre signature à un commentaire, ajouter quatre ~ (tildes) à la fin de votre commentaire. Ce raccourci permet d'afficher votre nom avec un lien vers votre page utilisateur et d'ajouter l'horodatage de votre commentaire. C'est très pratique dans les pages de discussion. Une méthode alternative consiste à cliquer sur le bouton signature au dessus de la fenêtre d'édition : c'est le deuxième en partant de la droite.
WikiThelia : Intonation, Style et Public
La "voix" du WikiThelia fait autorité, mais c'est aussi une voix de conversation amicale. Le style du WikiThelia doit être instructif en fournissant des explications aussi simples que possible et des conseils techniques au besoin.
En général, les articles s'adressent au lecteur, en le prenant dans le processus. Le pronom "Je" est à éviter, préférant l'utilisation de formules comme "vous cliquez ici" et "vous ouvrez le fichier modèle". Il ne s'agit pas de l'histoire de ce que vous avez fait ou des personnes qui vous ont aidés. Il s'agit d'apporter aux utilisateurs les informations nécessaires à la mise en place et au fonctionnement rapide de leur boutique Thelia.
Les listes à puces et numérotés doivent être utilisées pour mettre en avant les étapes importantes d'un processus. Les taches compliquées sont découpées en petites étapes, guidant novices et experts rapidement à la solution.
Tous n'ont pas les mêmes capacités et connaissances en HTML, XHTML, CSS, et PHP. Les articles, aussi bien destinés aux experts qu'aux débutants, utiliseront le vocabulaire d'un volontaire de support technique assis à côté de l'utilisateur, et le guideront pas à pas. Le WikiThelia doit écrit en langage simple avec les liens nécessaires au Glossaire.
Conventions
- Exemples de noms de site : Toujours utiliser example.com, example.org ou example.net lorsque vous avez besoin d'énoncer un domaine comme exemple. C'est la norme RFC2606
- Admin : Pour dénommer un administrateur de manière générale utilisez
admin(écrire <code>admin</code>). - Utiliser des noms de personnes en exemple : Pour dénommer un utilisateur non-administrateur ou une personne, utilisez "Jean" comme prénom, "Dupont" comme nom.
