FAQ et documentation ne rendent pas le même service
Une FAQ rassemble des réponses courtes à des questions récurrentes : quels documents préparer, comment modifier un rendez-vous, où retrouver une facture. Une documentation accompagne une tâche comportant plusieurs étapes, des prérequis ou des cas particuliers. Elle peut expliquer comment configurer un compte ou résoudre une erreur.
Une question revient dans les appels, un client ne retrouve pas une procédure, une collègue recopie la même réponse par courriel : voilà de bons points de départ pour une aide en ligne. Commencez par ces situations concrètes. Une documentation n’a pas besoin de couvrir tout votre métier dès son ouverture. Elle doit résoudre quelques problèmes fréquents avec des réponses fiables, faciles à retrouver et entretenues.
Ces formats peuvent cohabiter. La réponse courte oriente vers la procédure lorsque le lecteur a besoin de détails. Une FAQ commerciale, destinée à préciser une offre, relève encore d’un autre usage : notre page consacrée aux questions fréquentes et preuves aborde cette fonction. Ici, l’objectif est d’aider une personne déjà confrontée à une difficulté.
Recueillir les questions avant de construire les rubriques
Relisez les demandes de support et échangez avec les personnes qui y répondent. Notez les mots employés, la tâche recherchée et ce qui manque dans la réponse actuelle. Retirez les informations personnelles des exemples. Regroupez ensuite les demandes par action : démarrer, utiliser, modifier, résoudre un problème. Un classement par service interne oblige souvent le lecteur à connaître votre organisation.
Choisissez un premier ensemble limité de fiches que quelqu’un pourra réellement maintenir. Pour chaque sujet, désignez une personne capable de vérifier le fond. Ce travail de préparation des contenus web précède le choix d’un moteur de recherche ou d’un module d’accordéon.
Exemple fictif : l’aide d’un service de réservation
Imaginons un service de réservation d’ateliers. Son aide pourrait suivre cette structure, à adapter aux questions effectivement reçues :
- Avant de réserver : choisir un atelier, connaître les prérequis, consulter les dates.
- Gérer ma réservation : retrouver la confirmation, modifier les participants, demander un changement.
- Résoudre un problème : courriel absent, connexion impossible, réservation introuvable.
Une recherche « mail pas reçu » devrait permettre de trouver la fiche « Retrouver ma confirmation », même si son titre utilise un autre vocabulaire. Testez quelques formulations courantes, les fautes simples et les recherches sans résultat. Dans ce dernier cas, proposez des rubriques et un contact utile, plutôt qu’une impasse. Les questions mises en avant comme populaires doivent correspondre à des besoins observés.
Écrire une fiche qu’on peut suivre sans deviner
Commencez par le résultat attendu et les conditions nécessaires. Présentez ensuite une action par étape, avec les libellés réellement visibles dans l’interface. Les principes pour structurer un article lisible peuvent aussi servir aux fiches : titres explicites, progression claire et paragraphes consacrés chacun à une idée. Précisez ce que la personne doit voir après une opération sensible et quoi faire si le résultat diffère. Terminez par un recours : informations à préparer et moyen de joindre le support.
Si une capture est nécessaire, utilisez une capture réelle et actuelle, sans données confidentielles. Le texte doit rester compréhensible sans elle. Évitez de répéter intégralement une même procédure dans plusieurs fiches : un lien vers la version de référence simplifie les corrections. Le guide du maillage interne aide à organiser ces passages entre contenus.
Vérifier la consultation sur mobile et au clavier
Un accordéon convient à des réponses courtes ; une procédure longue gagne souvent à rester visible sur sa propre page. Pour un accordéon, le modèle W3C prévoit notamment l’activation par Entrée ou Espace, la navigation par Tabulation et l’annonce de l’état ouvert ou fermé. Vérifiez aussi que le focus reste visible et que les liens des réponses sont accessibles.
Faites chercher une réponse sur téléphone, puis sans souris. Cette vérification pratique peut révéler un titre incompréhensible ou un résultat difficile à atteindre. Elle complète une revue des parcours et de l’ergonomie, sans constituer à elle seule un audit d’accessibilité.
Prévoir l’entretien dès la première publication
Conservez pour chaque fiche un responsable, la version du produit concernée et une échéance de révision. Une modification d’interface doit déclencher la vérification des procédures associées. Un WordPress administrable peut faciliter cette organisation, mais ne remplace pas la relecture métier.
Pour suivre l’utilité de l’aide, examinez les recherches infructueuses et les demandes qui persistent après consultation. Un bouton « Cette réponse vous a-t-elle aidé ? » peut recueillir un signal, à interpréter avec les commentaires. Une page très consultée n’est pas nécessairement une bonne réponse. Une FAQ sert d’abord à répondre aux questions, pas à obtenir un affichage particulier dans Google.