Projet:Aide et accueil/Pages d'aide/Bonnes pratiques

Niveau avancé
Voici quelques bonnes pratiques concernant la création de pages d'aide.
Important : Rédiger des pages d'aide demande de l'expérience pour comprendre le contexte global, mais il ne faut pas écarter pour autant des personnes débutantes qui peuvent amener une nouvelle forme d'explications.
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.

Exemples
Mauvaise pratique Bonne pratique

Que faire sur Wikipédia?

  • 1 S'exercer à l'écriture et à la syntaxe avant de modifier les articles
  • 2 Grands axes de participation
  • 3 N'hésitez pas mais...
    • 3.1 Appuyez-vous sur des ressources valables
  • 4 Inspection, corrections et amélioration des articles
    • 4.1 Maintenance et amélioration des articles
  • 5 Se rendre utile en général
    • 5.1 Surveiller et voter à propos des articles
    • 5.2 Participer à la vie communautaire

Liste de suivi

  • Que veut dire « suivre » ?
  • 1 Comment suivre un article de son choix
    • 1.1 Via l'interface de lecture
    • 1.2 Via l'interface de modification
    • 1.3 Paramétrage
    • 1.4 Arrêter de suivre un article
    • 1.5 Suivi par thème
  • 2 Options et paramétrage
  • 3 Comprendre la liste de suivi
  • 4 Fonctions avancées
  • 5 Notes et références
    • 5.1 Notes
    • 5.2 Références

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.

Exemples
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.

Exemples
Mauvaise pratique Bonne pratique
  • Participer aux discussions
  • Créer un diagramme ou un schéma
  • Faire en sorte que les cas les plus évidents puissent ressortir
  • choisir la situation la plus adaptée
  • Participer aux discussions
  • Créer un diagramme ou un schéma
  • Faire ressortir les cas les plus évidents
  • Choisir la situation la plus adaptée

É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]]
 
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
 
Je suis une légende
 
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
  1. « Wikistats - Wikipédia en français : Appareils uniques par mois », sur stats.wikimedia.org (consulté le )
  2. Ajoutez ?useskin=vector ou ?useskin=minerva à l'URL de la page que vous vous souhaitez capturer. Cela vous basculera ponctuellement sur ces habillages