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

Une page de Wikipédia, l'encyclopédie libre.
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.

Aller au plus simple[modifier | modifier le code]

Il convient de se souvenir des notions de base : de quoi un débutant a-t-il 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 »)
  • insérer une image sera expliqué en utilisant la barre d'outils Vector, avant de parler de wikicode et de gadgets

Découper en plusieurs niveaux d'aide[modifier | modifier le code]

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

Mettre en avant l’essentiel[modifier | modifier le code]

L'utilisation de {{En-tête Aide}} permet d'indiquer une description de ce que la page d'aide couvre.

L'utilisation du modèle {{relief}} permet de mettre en avant les points essentiels d'une section :

Exemple :

Définir de quoi on parle[modifier | modifier le code]

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.

Mettre en place un système d'étapes et de validation[modifier | modifier le code]

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 | modifier le code]

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

Vector et Minerva sont les habillages par défaut[modifier | modifier le code]

Seuls des utilisateurs ayant déjà une certaine expérience sont volontairement sous Monobook ou Timeless.

L'aide concernant l'habillage Monobook est à présent une aide avancée, l’ensemble des comptes étant par défaut sous Vector.

Il ne faut pas non plus oublier l'interface mobile : la majorité du public lisant Wikipédia utilise l'apparence Minerva, pour mobile.

Les captures d'écran doivent donc être effectuées sur Vector et Minerva[1].

Des schémas clairs[modifier | modifier le code]

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 | modifier le code]

Ne pas confondre espace encyclopédique et page d'aide[modifier | modifier le code]

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 | modifier le code]

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 | modifier le code]

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 | modifier le code]

Un bon exemple se passe de description.

Exemple de mauvaise pratique[modifier | modifier le code]

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]] Je suis une légende

Exemple de bonne pratique[modifier | modifier le code]

Il existe deux façons d'afficher les images :

Avec vignette Sans vignette
Rendu
Je suis une légende
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

Notes[modifier | modifier le code]

  1. Ajoutez ?useskin=vector ou ?useskin=minerva à l'URL de la page que vous vous souhaitez capturer. Cela vous basculera ponctuellement sur ces habillages