knowledge-base

Principes clés

1. Écrire pour scanner, non pour lire - Les utilisateurs arrivent avec un problème spécifique et scannent pour trouver la réponse. Utilisez des paragraphes courts, des étapes numérotées, des termes clés en gras, et des titres clairs. Un mur de texte est un article que personne ne lit. Chaque section doit être trouvable en 2 secondes de scan.

2. La structure reflète le modèle mental de l'utilisateur - Organisez le contenu autour des tâches que les utilisateurs tentent de accomplir et des problèmes qu'ils rencontrent, pas autour de la structure interne de votre produit. « Comment inviter un coéquipier ? » est mieux que « Gestion des utilisateurs > Invitations > Créer des invitations ». Les utilisateurs pensent en résultats, pas en menus.

3. La recherche est la navigation primaire - La plupart des utilisateurs ne consulteront jamais votre arborescence de catégories. Ils saisiront une requête et cliqueront sur le premier résultat plausible. Chaque titre d'article, résumé et ensemble de mots-clés doivent être optimisés pour les mots que les utilisateurs tapent réellement, pas pour ceux que votre équipe produit utilise en interne.

4. Mesurez la déflexion, pas les pages vues - Les pages vues vous montrent ce que les gens regardent. La déflexion vous montre si cela a fonctionné. Suivez le volume de tickets par rapport au trafic du centre d'aide, les évaluations d'articles, les recherches échouées et les clics « nous contacter » après la consultation d'articles. Un article à fort trafic avec un taux élevé de clics « nous contacter » est un article qui échoue.

5. Maintenez impitoyablement - Un article obsolète est pire qu'aucun article. Il crée une fausse confiance et des tickets d'assistance remplis de « J'ai suivi l'article et ça n'a pas marché ». Chaque article doit avoir un propriétaire, une date d'examen et un processus clair pour le marquer comme obsolète ou l'archiver quand la fonctionnalité change.

Concepts fondamentaux

Architecture de l'information

L'architecture de l'information (AI) est la façon dont le contenu est organisé, étiqueté et lié. Une bonne AI signifie que les utilisateurs peuvent trouver des réponses en deux clics ou moins depuis la page d'accueil du centre d'aide.

Principes de conception de la taxonomie :

• Les catégories de haut niveau correspondent aux objectifs des utilisateurs, pas aux fonctionnalités du produit
• 5 à 8 catégories de haut niveau est le maximum pratique avant que la navigation ne devienne accablante
• Chaque article appartient à exactement une catégorie primaire (les liens croisés vont bien ; le double hébergement crée une dette de maintenance)
• Les noms de catégories utilisent le langage courant : « Facturation et paiements » est mieux que « Opérations de revenus »
• Les sous-catégories ajoutent un niveau de spécificité - évitez l'imbrication au-delà de deux niveaux

Test de validation de la taxonomie : Montrez la structure de catégories à cinq utilisateurs qui ne l'ont jamais vue. Demandez-leur où ils cherchent raient pour une tâche commune spécifique. Si moins de quatre sur cinq trouvent la bonne catégorie, repensez les étiquettes.

Types d'articles

La plupart des articles doivent être des guides pratiques ou du dépannage. Si votre base de connaissances est principalement composée d'articles conceptuels, les utilisateurs ne trouvent pas de réponses actionnables - ils sont éduqués quand ils veulent être débloqués.

Optimisation de la recherche

La recherche dans une base de connaissances est une correspondance de mots-clés plus classement, pas une compréhension sémantique (même avec une recherche alimentée par l'IA, l'optimisation explicite gagne toujours).

La stratégie des mots-clés à trois niveaux :

Niveau 1 - Mots-clés de titre :   Mots que les utilisateurs tapent quand ils savent ce qu'ils veulent
                                   (« réinitialiser le mot de passe », « annuler l'abonnement », « exporter CSV »)

Niveau 2 - Synonymes :             Termes alternatifs pour le même concept
                                   (« réinitialiser » = « oublié », « changer », « récupérer »)
                                   (« annuler » = « supprimer le compte », « fermer le compte », « se désabonner »)

Niveau 3 - Chaînes d'erreur :     Messages d'erreur exacts que les utilisateurs copient-collent dans la recherche
                                   (« Erreur 403 : Interdit », « L'authentification SMTP a échoué »)

Stockez les synonymes dans le dictionnaire de synonymes de votre outil de recherche afin que les deux termes se résolvent aux mêmes résultats. Ne forcez jamais les utilisateurs à deviner la terminologie « correcte ».

Métriques de déflexion

La déflexion est le pourcentage d'utilisateurs qui trouvent une réponse dans la base de connaissances et n'ouvrent pas de ticket d'assistance. C'est la métrique de santé primaire d'une base de connaissances.

Formule du taux de déflexion :

Taux de déflexion = 1 - (tickets ouverts après visite KB / total visites KB)

Métriques de support à suivre :

Tâches courantes

Concevoir l'architecture du centre d'aide - taxonomie

Étape 1 : Exploiter vos données de tickets

Extrayez 90 jours de tickets d'assistance et étiquetez chacun avec l'objectif sous-jacent de l'utilisateur (pas la fonctionnalité impliquée). Les 10 objectifs principaux en volume deviennent vos candidats de catégorie.

Étape 2 : Validation par tri de cartes

Donnez à 8-10 utilisateurs représentatifs 20-30 titres d'articles sur des cartes. Demandez-leur de grouper les articles en catégories et de nommer chaque groupe. Les motifs apparaissant dans 6+ des 8 groupages d'utilisateurs sont des catégories validées.

Étape 3 : Construire la hiérarchie

Niveau 0 : Accueil du centre d'aide
Niveau 1 : 5-8 catégories basées sur les objectifs  (p. ex., « Premiers pas », « Facturation », « Paramètres du compte »)
Niveau 2 : Sous-catégories par Niveau 1  (p. ex., « Facturation > Factures », « Facturation > Méthodes de paiement »)
Niveau 3 : Articles individuels

Étape 4 : Mapper le contenu existant

Auditez chaque article existant par rapport à la nouvelle taxonomie. Pour chaque article : conserver, fusionner, réécrire ou archiver. Ne migrez pas les articles obsolètes - la migration est une fonction de forçage pour décider si le contenu vaut la peine d'être conservé.

Écrire des articles d'assistance efficaces - modèle

Voir references/article-templates.md pour les modèles complets par type d'article.

Règles d'écriture universelles :

• Format du titre : verbe + objet + contexte optionnel. « Réinitialiser votre mot de passe » pas « Réinitialisation du mot de passe »
• Première phrase : indiquez exactement ce que couvre l'article et pour qui
• Les étapes utilisent des listes numérotées ; les sous-étapes utilisent des listes numérotées indentées
• Ajoutez des captures d'écran et des vidéos pour les étapes où le placement dans l'interface utilisateur est ambigu
• Mettez en gras la première mention d'un élément de l'interface utilisateur : « Cliquez sur Enregistrer les modifications »
• Terminez chaque article par une évaluation « Cet article a-t-il été utile ? » et un lien pour contacter l'assistance

Cibles de longueur :

Optimiser la recherche - mots-clés et synonymes

Flux de travail d'audit des mots-clés :

1. Exportez les recherches échouées des 30 derniers jours (requêtes avec zéro résultats ou zéro clics)
2. Regroupez les recherches échouées similaires en groupes de synonymes
3. Pour chaque groupe : existe-t-il un article pertinent ? Si oui, ajoutez des synonymes. Si non, ajoutez au carnet de contenu.
4. Exportez les recherches avec un faible taux de clics (résultats affichés mais non cliquées) - cela indique une non-correspondance de titre
5. Réécrivez les titres d'articles pour correspondre à la langue que les utilisateurs utilisent dans les requêtes à faible taux de clics

Construire le dictionnaire des synonymes :

Groupe : mot de passe
Synonymes : mot de passe oublié, réinitialiser le mot de passe, changer le mot de passe, récupérer le compte,
            verrouillé, impossible de se connecter, aide à la connexion

Groupe : supprimer le compte
Synonymes : supprimer le compte, fermer le compte, se désabonner, supprimer le compte,
            arrêter l'abonnement, quitter [nom du produit]

Groupe : facturation
Synonymes : facture, reçu, facturation, paiement, carte de crédit, coût d'abonnement, prix

Examinez et développez le dictionnaire de synonymes tous les trimestres à l'aide de nouvelles données de recherches échouées.

Mesurer et améliorer le taux de déflexion

Configuration de la mesure de déflexion :

1. Instrumentez votre centre d'aide avec le suivi de session
2. Définissez un « événement de déflexion » : l'utilisateur visite la KB et ne clique PAS sur « Contacter le support » ou n'ouvre pas de ticket au cours de la même session
3. Définissez un « événement d'échec » : l'utilisateur visite la KB ET ouvre un ticket ou clique sur « Contacter le support »
4. Calculez : taux de déflexion = événements de déflexion / (événements de déflexion + événements d'échec)

Playbook d'amélioration de la déflexion :

Créer des modèles d'article par type

Voir references/article-templates.md pour des modèles prêts à l'emploi pour :

• Articles de guides pratiques
• Articles de dépannage
• Articles de FAQ
• Articles de référence

Construire un flux de travail de maintenance

Modèle de propriété du contenu :

Chaque article doit avoir un propriétaire nommé (une personne, pas une équipe). Le propriétaire est responsable de l'examen de l'article quand la fonctionnalité associée change et selon un cycle régulier.

Cadence d'examen :

Flux de travail de maintenance :

Déclencheur :  Lancement de fonctionnalité, changement de produit, ou date d'examen programmée
Étape 1 :      Le propriétaire vérifie chaque étape par rapport au produit actuel
Étape 2 :      Mettre à jour les captures d'écran, le texte des étapes et les noms d'options
Étape 3 :      Augmenter la date « Dernièrement examiné » dans les métadonnées de l'article
Étape 4 :      Si l'article couvre une fonctionnalité supprimée : archiver, ne pas supprimer
               (les liens externes se brisent ; les articles archivés doivent rediriger vers un avis)
Étape 5 :      Notifier l'équipe d'assistance des changements significatifs pour les tickets en vol

Automatisation de la détection de l'ancienneté : Configurez un script ou une intégration qui marque tout article dont la date « Dernièrement examiné » dépasse le seuil d'examen. Envoyez-les à un rapport « santé du contenu » hebdomadaire envoyé aux propriétaires d'articles.

Mettre en œuvre l'aide intégrée au produit - conseils contextuels

L'aide contextuelle affiche l'article approprié au moment du besoin, à l'intérieur du produit, sans obliger l'utilisateur à naviguer.

Motifs d'aide contextuelle :

Règles pour le texte d'aide contextuelle :

• Écrivez à la deuxième personne : « Vous pouvez ajouter jusqu'à 5 coéquipiers avec ce plan »
• Indiquez ce que l'utilisateur peut faire, pas ce que le système fait
• Liez vers l'article KB complet pour tout ce qui nécessite plus de 2 phrases
• Ne dupliquez jamais l'article complet dans une infobulle - résumez et liez

Anti-motifs

Pièges

1. Les données de recherche échouées sont le signal le plus précieux et la plupart des équipes l'ignorent - La plupart des tableaux de bord analytiques du centre d'aide affichent les pages vues et les évaluations d'articles. Les données au signal le plus élevé sont les recherches échouées (requêtes qui retournent zéro résultats ou zéro clics). Ce sont des utilisateurs qui sont venus chercher de l'aide et sont partis les mains vides. Tirez ce rapport hebdomadalement et traitez-le comme un carnet de contenu manquant.

2. Organiser par structure de fonctionnalité du produit au lieu du modèle mental de l'utilisateur cause des taux de rebond élevés - Quand les utilisateurs voient des catégories comme « Paramètres d'espace de travail > Membres > Flux d'invitation », ils doivent traduire leur problème (« comment ajouter quelqu'un ») dans votre taxonomie interne du produit. Les utilisateurs qui ne trouvent pas la catégorie en 3 secondes partent et ouvrent un ticket. Validez toujours les noms de catégories avec de vrais utilisateurs avant de lancer.

3. Les titres d'article rédigés pour le SEO mais pas pour le scan produisent des taux de clics faibles dans la recherche - Un titre comme « Guide complet de la gestion des mots de passe dans vos paramètres de compte » est verbeux et enterre l'action. Les utilisateurs qui scannent les résultats de recherche pour « réinitialiser le mot de passe » doivent voir ces mots dans le titre. Gardez les titres courts, verbe d'abord, et correspondez au langage exact que les utilisateurs tapent lors de la recherche.

4. Les évaluations d'articles élevées sur un contenu obsolète créent un faux signal de santé - Les utilisateurs qui ont trouvé une solution de contournement ou qui ont compris par eux-mêmes évaluent souvent l'article positivement malgré qu'il soit partiellement incorrect. Le suivi de l'ancienneté des articles (jours depuis le dernier examen) doit fonctionner en parallèle avec les évaluations - un article 4 étoiles qui n'a pas été examiné depuis 18 mois pour une fonctionnalité qui change est toujours un passif.

5. Les baisses du taux de déflexion sont invisibles sans suivi au niveau de la session - Si vous mesurez la déflexion comme « tickets ouverts / total pages vues KB » au lieu du niveau session, vous ne pouvez pas dire si les utilisateurs qui ont ouvert des tickets ont d'abord visité la KB. Le suivi au niveau de la session (l'utilisateur a visité la KB puis a ouvert un ticket au cours de la même session) est le seul signal d'échec précis.

Références

Pour des modèles et motifs détaillés, chargez le fichier pertinent depuis references/ :

• references/article-templates.md - modèles prêts à l'emploi pour les guides pratiques, dépannage, FAQ et articles de référence avec des exemples annotés

Chargez un fichier de références uniquement quand la tâche actuelle le nécessite.