Projet:Aide et accueil/Pages d'aide/Bonnes pratiques
Les personnes débutantes qui se retrouvent face à une page d'aide impossible à modifier sont invitées à proposer leurs modifications sur la page de discussion de la page concernée.
Objectif : aller au plus simple modifier
Il convient de se souvenir des notions de base : qu'est-ce qu'une personne débutante a le plus besoin de savoir ?
Il est rarement utile de faire de grosses constructions logiques : l'intérêt d'une page d'aide n'est pas de démontrer, mais d'expliquer.
LA priorité va aux outils proposés par défaut, par exemple :
- l'éditeur visuel est l'outil par défaut des nouveaux utilisateurs (lien « modifier ») y compris sur mobile ;
- insérer une image sera expliqué en utilisant la barre d'outils Vector, avant de parler de wikicode et de gadgets (qui sont traités dans une aide avancée).
Découpage des pages modifier
Découper en plusieurs niveaux d'aide modifier
Il est possible de séparer des pages en fonction du niveau d'aide. Cela permet d'aller à l’essentiel sur la première page (débutants) et d'éviter l'impression de devoir avaler une immense page.
Comment déterminer les niveaux :
- débutant : il est possible de résumer comment faire l'action concernée en quelques lignes
- avancé : il est nécessaire de maîtriser quelques bases avant de tenter l'action, l'action demande de passer par du wikicode, ou un autre type de code.
- expert : il est nécessaire d'avoir atteint un certain statut, ou d’activer des outils qui ne sont pas ceux présentés par défaut (préférences, gadgets...)
Découper en plusieurs pages d'aide modifier
Une longue page d'aide peut être décourageante voire être source de confusions. Mieux vaut préparer plusieurs pages d'aide, présentant un sujet ou une action, unique et précis, plutôt que de tout regrouper sur une seule page.
Par exemple, une page unique sur l'insertion d'images sera très longue. Mieux vaut préférer des pages séparées par technologie, par niveau de difficulté, etc.
Bien entendu, chaque page présentera les renvois appropriés vers les autres pages d'aide proches.
Structurer une page d'aide modifier
Mettre en avant l’essentiel modifier
L'utilisation de {{En-tête Aide}} permet d'indiquer une description de ce que la page d'aide couvre, mais aussi d'indiquer des pages d'aide dont la lecture préalable est à prendre en compte.
Une section « En résumé » est conseillée en en-tête de la page d'aide, afin de regrouper l'essentiel de ce qu'il faut retenir.
L'utilisation du modèle {{relief}} permet de mettre en avant les points essentiels d'une section :
Exemple :
L'utilisation du gras est à réserver pour mettre en avant un point important ou un terme défini.
Définir de quoi on parle modifier
Le vocabulaire wikipédien est vaste et complexe à appréhender. Il faut donc éviter les acronymes et autres raccourcis utilisés seuls sur les pages d'aide de niveau « débutant » ou « avancé ». Ces termes sont à expliciter : « ...vous pouvez consulter la page de discussion (PdD) de l'article... ».
Il arrive parfois qu'un concept entier doive être présenté. Par exemple, si la page d'aide est à propos de la liste de suivi, il faut expliquer ce que « suivre » signifie dans ce contexte avant même de se lancer dans l'explication sur ce qu'est une liste de suivi.
Si la page d'aide présente une règle ou une recommandation, il faut alors rappeler ou résumer cette règle dès le début de la page d'aide, avec un renvoi vers la règle ou une recommandation.
Mettre en place un système d'étapes et de validation modifier
Pour une procédure en plusieurs étapes, pensez à résumer les éléments à avoir pour passer à celle d'après. Avertir qu'un manque peut être problématique (exemple : pas de sources à la création d'un article).
Exemple :
Questions-guide
- Qui parle de mon sujet ? Est-ce un média reconnu ?
- Les critères d'admissibilité sont-ils remplis pour mon sujet ?
- Ai-je vérifié que le sujet choisi n’est pas déjà traité ?
L'utilisation de {{En-tête Aide}} permet d'indiquer des lectures préalables à la réalisation de ce qu'explique la page d'aide.
Faire un plan cohérent modifier
Chaque page d'aide guide son lecteur d'un point A (je ne sais pas modifier une page, qu'est-ce qu'une liste de suivi?) vers un point B (je sais modifier une page, je connais les usages de la liste de suivi). Un bon découpage progressif en sections (ou en sous-page pour un système pas à pas) permet au lecteur de voir ce qui l'attend et de ne pas être perdu dans sa lecture. On préférera un titre avec un verbe d'action "Activer machin chose" si possible.
| Mauvaise pratique | Bonne pratique |
|---|---|
|
Que faire sur Wikipédia?
|
Liste de suivi
|
Des schémas clairs modifier
Des schémas sont parfois nécessaires pour la bonne compréhension de la page. Il convient de les faire claires, sans surcharge, avec des couleurs appropriées et homogènes. Mieux vaut plusieurs schémas qu'un seul surchargé.
Le schéma est avant tout illustratif : il ne se substitue pas à un texte bien pensé, clair et court. Dans le cas d'un schéma indispensable, un texte alternatif décrivant le schéma est à prévoir pour les personnes mal-voyantes (balise |alt= dans l'inclusion de l'image).
Rédaction modifier
L'expérience compte modifier
Attention aux biais liés à l'expérience.
Rédiger une page d'aide est difficile pour une personne débutante, bien que ce soit sans doute la personne la plus a même de mettre en relief les difficultés qu'elle rencontre.
Rédiger une page d'aide est facile pour une personne expérimentée qui connaît les règles, les outils, la culture de Wikipédia. Mais cette expérience peut aussi amener à passer trop rapidement sur des points déjà acquis, ou à privilégier des solutions peu accessibles à des personnes débutantes.
Il est donc important de prendre en compte sa propre expérience de Wikipédia et de prendre du recul par rapport à celle-ci.
Vector et Minerva sont les habillages par défaut modifier
Seuls des utilisateurs ayant déjà une certaine expérience sont volontairement sous Monobook ou Timeless, ou conservent l'ancien habillage Vector. L'aide concernant ces habillages est une aide de niveau avancé, l’ensemble des comptes étant par défaut sous Vector.
Il ne faut pas non plus oublier l'interface mobile : 60% du public lisant la Wikipédia en français utilise l'apparence Minerva, pour mobile[1].
Les captures d'écran doivent donc être effectuées à la fois pour Vector et Minerva[2].
Ne pas confondre espace Wikipédia: et page d'aide modifier
Les pages dans l'espace de noms Wikipédia: présentent les règles, recommandations... Les page dans l'espace de noms Aide: présentent comment ces règles et recommandations sont appliquées.
Aucun contenu d'aide ne devrait figurer dans l'espace de noms Wikipédia:.
Les liens présents dans une page d'aide doivent pointer vers des contenus d'aide et non repartir vers l’espace Wikipédia:, hormis pour renvoyer vers la lecture d'une règle ou recommandation particulière.
Ne pas confondre espace encyclopédique et page d'aide modifier
Les liens présents dans une page d'aide doivent pointer vers des contenus d'aide et non repartir vers l’espace encyclopédique. Mieux vaut quelques mots en plus détaillant une notion plutôt que de renvoyer vers l'article correspondant, qui n'a pas pour vocation d'être pédagogique.
| Mauvaise pratique | Bonne pratique |
|---|---|
| Le wiki-texte est un langage de balisage, destiné à être parsé. | Le wiki-texte est un langage à balises (on encadre chaque élément dont on veut changer l'apparence par des symboles prédéfinis), destiné à être mis en forme par le logiciel (le terme technique est « parsé »). |
Il est possible de prévoir un encart renvoyant vers l'espace encyclopédique.
Mettre en forme les listes de manière cohérente modifier
Lorsqu'on commence chaque item par un mot en gras ou par une majuscule, il faut veiller à ne pas rompre ce choix.
| Mauvaise pratique | Bonne pratique |
|---|---|
|
|
Éviter d'avoir une seule sous-section dans une section modifier
L'idée des sous-sections est de montrer différents cas qui se posent au vue de la section supérieure. S'il n'y a qu'une seule sous-section soit celle-ci devrait être une section à part soit elle doit être réintégrée à la section supérieure.
Décrire les exemples modifier
Un bon exemple se passe de description.
Exemple de mauvaise pratique modifier
Le tableau explicatif ci-dessous va montrer la différence si vous utilisez différents paramétrages lors de l'insertion d'une image: vignette va mettre l'image dans un cadre avec la possibilité de mettre une légende. Cette image s'alignera à droite et pour indiquer le texte alternatif (pour les malvoyants), il faut rajouter |alt=blabla. Sans vignette la légende équivaut au texte alternatif et l'image s'aligne à gauche.
| wikicode | rendu |
|---|---|
| [[Image:Exemple.png|vignette|Je suis une légende]] |  |
| [[Image:Exemple.png|Je suis une légende]] |
|
Exemple de bonne pratique modifier
Il existe deux façons d'afficher les images :
| Avec vignette | Sans vignette | |
|---|---|---|
| Rendu | |
|
| Wikicode | [[Image:Exemple.png|vignette|Je suis une légende]] | [[Image:Exemple.png|180px|Je suis une légende]] |
| Alignement | A droite | A gauche |
| Largeur | La largeur est limitée à 180 pixels par défaut | La taille est celle de l'image |
| Accessibilité | Pour les malvoyants, il faut rajouter |alt=blabla
|
La légende est aussi le texte pour les malvoyants |
Toujours rappeler qu'il est possible d'obtenir de l'aide modifier
Si vous sentez qu'un sujet est trop complexe pour que les pages d'aide couvent tous les cas, n'hésitez pas à rappeler que des être humains peuvent aussi aider. L'option la plus simple est de renvoyer vers le forum des nouveaux.
Exemple pour une liste de pratiques courantes mais non exhaustive : « Si votre cas de figure n'est pas listé ci-dessus, nous vous invitons à poser la question sur le forum des nouveaux, où une personne expérimentée vous répondra. »
Personne ne lit les pages d'aide modifier
Cette boutade traduit une réalité : le fonctionnement de Wikipédia est très ouvert et peut fonctionner sans avoir à lire au préalable toutes les pages d'aide. Et il faut être honnêtes : personne ne lit les modes d'emploi, que ce soit pour une encyclopédie en ligne, un micro-ondes ou une voiture.
Si vous constatez qu'un point d'une page d'aide n'est pas pris en compte par quiconque, posez vous quelques questions avant de venir mettre en gras et en rouge le point concerné dans une page d'aide :
- est-ce que la personne qui a mal fait une action avait bien eu l'information concernant cette action ?
- avez-vous expliqué à cette personne comment faire l'information correctement la prochaine fois ?
- est-ce que le problème rencontré est lié à la complexité d'un concept (appréhension de ce qu'est une source, ou compréhension de ce que sont les critères d'admissibilité, etc.) ?
- est-ce que le problème rencontré est lié à un problème d'interface ? (bandeau ou message système peu clair, manque de compréhension de l'interface, etc.)
N'hésitez pas à venir parler de difficultés que vous identifiez avec le projet aide et accueil.
Voir aussi modifier
- Comment créer des contenus d'aide, recommandations de l'équipe Croissance de la Fondation Wikimedia.
Notes modifier
- « Wikistats - Wikipédia en français : Appareils uniques par mois », sur stats.wikimedia.org (consulté le )
- Ajoutez
?useskin=vectorou?useskin=minervaà l'URL de la page que vous vous souhaitez capturer. Cela vous basculera ponctuellement sur ces habillages