bbulman/findability

Trouvabilité

« Les gens ne trouvent pas » est un symptôme qui a quatre causes habituelles, et chacune nécessite une correction différente. Cette compétence sert à décider ce qu'il faut changer en premier : elle sépare la cause de la plainte, choisit la correction la moins coûteuse qui y remédie et définit une mesure qui montre si cela a fonctionné.

Avant de commencer

Vous avez besoin	Si c'est manquant
Ce que les gens ne trouvent pas, qui ils sont et où ils ont cherché	Demandez. Si cela reste vague, listez les candidats et traitez-les comme des hypothèses.
Le site, l'application ou au moins sa navigation	Demandez. Sans cela, vous ne pouvez qu'écrire le plan de diagnostic.
Un journal de recherche au format CSV : query,count,results et clicks si disponibles	Dites ce qu'il faut exporter et pour quelle période. Fournissez le plan de diagnostic, les mesures et les tableaux vides. N'estimez jamais ce que le journal aurait dit.
Analytics, questions d'assistance, un inventaire	Dites quelles conclusions elles modifieraient et marquez-les comme non confirmées.

Méthode

1. Rédigez l'échec sous forme de tâche. « Un [qui] essayant de [objectif] cherche dans [où] [quoi], et [ce qui se passe]. » Une ligne par plainte, dans leurs mots.

2. Lisez le journal et utilisez ses chiffres.

   node "${CLAUDE_SKILL_DIR}/scripts/search-log.mjs" searches.csv
   

   Si le journal est trop petit pour être classé, utilisez-le comme une liste des mots tapés et indiquez « aucun taux ». Précisez la période que couvre l'exportation ; le script ne peut pas le savoir.

3. Diagnostiquez avant de prescrire. Traitez les causes dans cet ordre, car chacune repose sur la précédente. Plusieurs peuvent s'appliquer à la fois. Marquez chaque conclusion comme confirmée ou inférée.

   Cause	Comment la confirmer	Correction habituelle	Compétence
   Manquant : cela n'existe pas	Regardez sous tous les noms utilisés. Requêtes à zéro résultat sans contenu correspondant nulle part	Créez-le, ou dites clairement qu'il n'est pas proposé	content-inventory
   Mal étiqueté : cela existe sous un autre nom	Leur mot donne zéro résultat ou aucun clic alors que le contenu se trouve sous le vôtre ; rebonds	Renommez, ajoutez des synonymes	labeling
   Enterré : bien nommé, pas de chemin pour y accéder	Comptez les étapes depuis l'accueil et les hubs ; recherchez les orphelins, les culs-de-sac, la pagination profonde comme seul chemin, les recherches commencées sur la page de section qui aurait dû le proposer	Liez-le là où les gens regardent déjà, ou déplacez-le	navigation, sitemaps
   La recherche échoue : cela existe, la requête correspond, les résultats sont mauvais	Exécutez vous-même les meilleures requêtes et lisez les résultats ; résultats sans clics, reformulations, sorties de la page de résultats	Meilleurs choix, synonymes, périmètre d'index, classement	Étape 5

   De nombreux problèmes de trouvabilité sont moins coûteux à corriger dans les étiquettes et le regroupement que dans le moteur de recherche, alors ne commencez pas par le moteur. La profondeur seule n'est pas un défaut : la règle des trois clics est un mythe, et les gens cliquent plus loin lorsque chaque étape ressemble clairement à leur objectif.

4. Décidez quelle voie devrait fonctionner. Soutenez la navigation et la recherche, car les gens passent de l'une à l'autre. Les meilleures requêtes doivent être accessibles en une ou deux étapes depuis l'accueil.

   La personne	Voie à renforcer
   Connaît le nom exact	Recherche, ou une liste alphabétique
   Connaît le besoin mais pas le nom	Navigation avec des étiquettes claires, puis facettes
   Explore ou compare	Navigation, filtres, liens connexes
   Revient à quelque chose	Éléments récents, vues enregistrées, raccourcis
   Est en milieu de tâche	Un lien contextuel ou un indice à l'endroit où il travaille

5. Corrigez la recherche là où la recherche est la cause. Placez des meilleurs choix organisés en haut des résultats pour les meilleures requêtes. Construisez des ensembles de synonymes à partir des groupes de variantes du script, en commençant par ceux marqués SYNONYM WOULD ANSWER, puis ajoutez ce que seule une personne repère, comme les acronymes et le jargon. Ne laissez jamais une page sans résultat être une impasse. references/search-tuning.md couvre les trois aspects et ce qu'il faut exporter.

6. Placez des indices là où la décision se prend. Un bon indice répond à une question que la personne a déjà, au moment où elle fait le choix, à l'endroit où elle regarde déjà, discrètement et à moindre coût. La flèche à côté de la jauge de carburant d'une voiture qui montre de quel côté se trouve le bouchon est le modèle. Lisez references/routes-and-cues.md avant d'ajouter un indice ou un point d'entrée personnalisé.

7. Si quelqu'un propose un chat IA comme correctif, testez-le d'abord. Les boutons et les menus permettent aux gens d'agir et montrent ce que le système peut faire. Une boîte de chat ouverte fait la première chose lentement et la seconde pas du tout.

   Situation	Meilleure réponse
   Un ensemble limité et connaissable d'options	Boutons, menus ou filtres
   Les gens ne savent pas ce que le système peut faire	Structure visible ; une boîte vide n'enseigne rien
   Une tâche répétée avec des étapes connues	Un chemin direct
   Le contenu est manquant ou mal étiqueté	Corrigez cela d'abord ; le chat ne peut pas récupérer ce qui n'est pas là
   Vraiment ouvert, formulé différemment à chaque fois	Le chat peut gagner sa place, avec une structure autour

8. Définissez des mesures que vous pouvez réellement collecter. Prenez une base de référence avant de changer quoi que ce soit, une mesure par problème. S'il n'y a pas de base de référence, dites-le.

   Mesure	Provient de	Cible
   Temps pour trouver un article simple	Un test chronométré avec des personnes	Moins de 30 secondes
   Succès de la tâche	Un test de tâche ou un test d'arborescence	Au moins 70 %, et 80 % pour les tâches principales
   Part de recherches sans résultat	Journal de recherche	En dessous de sa propre base de référence
   Sorties de recherche, reformulations	Analytics, si la page de résultats est suivie	En dessous de sa propre base de référence
   Volume d'assistance sur ce sujet	Bureau d'aide, s'il est étiqueté	En dessous de sa propre base de référence

   references/measures.md explique ce que chacune peut et ne peut pas montrer.

Livrable

Écrivez findability-diagnosis.md sauf si l'utilisateur nomme un autre fichier, dans cet ordre : Recommandation (deux ou trois phrases) ; Les échecs, sous forme de tâches ; Preuves (source, période, chiffres du script) ; Diagnostic (chose, cause, preuve, confirmé ou inféré) ; Options (deux ou trois, avec ce que chacune coûte et ce qu'elle laisse non corrigé) ; Liste des correctifs dans l'ordre, avec la compétence qui prend chacun ; Meilleurs choix et synonymes (query, action, target) ; Page sans résultat, le cas échéant ; Mesures (nom, base de référence, cible, source, date de re-vérification) ; Hypothèses et ce qui n'était pas disponible.

Tâche	Rendez
Une chose que personne ne trouve	Échec, cause, preuve, correctif et une mesure, dans la réponse
Un journal de recherche à lire	Preuves, meilleurs choix et synonymes, et les lacunes sans résultat
« La trouvabilité est mauvaise sur tout le site »	Le document complet

Placez les longs tableaux en dernier. Un document plus long n'est pas un document plus approfondi.

Vérifiez-le

• Chaque chiffre provient d'une exécution du script ou d'une source donnée par l'utilisateur. Réexécutez le script si le journal a changé.
• Chaque correctif nomme la cause qu'il traite, et chaque cause a une preuve ou est marquée comme inférée.
• Vous avez exécuté les meilleures requêtes vous-même si vous y aviez accès, car le journal ne peut pas dire si les résultats étaient bons.
• Vous avez vérifié que chaque synonyme proposé signifie la même chose. Le script groupe par orthographe, il peut donc associer des mots qui diffèrent par leur sens.
• Les journaux de recherche peuvent contenir des noms et des e-mails tapés dans la boîte. Le script masque les adresses e-mail ; ne copiez pas d'autres données personnelles dans le rapport.

Ce que Claude ne peut pas faire ici

Vous ne pouvez pas regarder de vraies personnes chercher, les chronométrer ou connaître la stratégie de l'organisation sauf si on vous le dit. N'inventez jamais de chiffres d'utilisation, de volumes de recherche, de taux de réussite ou de citations ; une mesure sans données est présentée comme non encore collectée. Proposez des alternatives avec leurs compromis, recommandez-en une et dites pourquoi ; l'humain possède la décision. Ce qu'un produit de recherche peut faire (synonymes, résultats épinglés, journalisation des requêtes) varie, alors dites ce à quoi vous vous attendez et demandez à l'utilisateur de le confirmer.

Où cela passe la main

Prochain besoin	Compétence
Découvrir ce qui existe	content-inventory
Le nom est mauvais	labeling
Les termes et les filtres nécessitent du travail	taxonomies
Les groupes ne correspondent pas à la façon dont les gens pensent	card-sort
Le chemin pour y accéder est manquant	navigation, sitemaps
Tester une hiérarchie modifiée	tree-tests
Champs nécessaires pour les facettes ou les aperçus	content-models
Une page se déplace	url-structure, redirect-maps
Une restructuration complète du site, ou incertitude sur où commencer	information-architecture