bbulman/labeling

Libellés

Les libellés sont les mots qui indiquent aux gens ce qui se cache derrière une porte avant qu'ils ne l'ouvrent. Cette compétence sert à décider comment appeler chaque destination, section ou action, et quel système de nommage utiliser à chaque niveau. Le test pour chaque libellé : un nouvel arrivant pourrait-il prédire ce qui se cache derrière ?

Avant de commencer

Vous avez besoin	Si c'est manquant
Les libellés actuels, chacun avec ce qui se cache derrière et où il apparaît	Lisez la navigation ou demandez-la. S'il n'y a encore rien, fournissez le fichier labels.csv vide et le plan de test.
Qui les lit et ce qu'ils essaient de faire	Demandez. Si aucune réponse n'arrive, indiquez votre hypothèse en haut.
Les mots des utilisateurs eux-mêmes : logs de recherche, questions support, noms de groupes de tri par cartes, entretiens, avis	Élaborez à partir du contenu et des conventions de produits similaires, marquez chaque libellé untested, et fournissez le plan de test pour que les mots puissent être vérifiés. Ne présentez jamais une supposition comme le langage des utilisateurs.

Méthode

1. Listez les libellés en contexte. Enregistrez pour chacun son groupe (les libellés vus ensemble), sa destination et ce qui se cache vraiment derrière. Juger un libellé sans ses voisins, c'est ainsi que les chevauchements passent inaperçus.

2. Collectez les mots des utilisateurs. Leurs mots sont les premiers candidats ; vos termes internes ne le sont pas.

   Source	Ce qu'elle vous donne	Attention
   Logs de recherche	Les mots exacts saisis, les mots déclencheurs les plus forts	Exécutez le rapport de logs de la compétence findability ; n'estimez jamais les volumes
   Questions support	Comment les gens décrivent le besoin	Les personnes en difficulté formulent les choses différemment
   Noms de groupes de tri par cartes	Comment les gens appellent un regroupement	Utilisez leurs mots les plus courants
   Entretiens, 5 à 10 personnes	Le vocabulaire et ce que les mots signifient pour eux	Écoutez le mot qu'ils utilisent spontanément
   Produits similaires	Des mots que les gens ont déjà appris	Le familier bat l'ingénieux

3. Choisissez un système de libellés par niveau. Mélanger les systèmes dans un même menu signifie que chaque élément répond à une question différente, et les gens ne peuvent pas les comparer.

   Système	Exemple	Fonctionne quand	Casse quand
   Tâche	« Suivre une commande »	Les gens arrivent avec un travail à faire	Les tâches se chevauchent ou la liste s'allonge
   Audience	« Pour les développeurs »	Des groupes ont besoin de contenus différents et peuvent se situer eux-mêmes	Quelqu'un est dans deux groupes, ou ne sait pas lequel
   Sujet	« Facturation »	Le sujet est la façon dont les gens y pensent	Les sujets sont ceux de l'organisation, pas les leurs
   Format	« Vidéos », « Modèles »	Les gens choisissent par format	Ils se soucient d'abord du sujet
   A à Z	Glossaires, annuaires	Les gens connaissent le nom exact	Ils naviguent pour découvrir

4. Rédigez des candidats selon ces règles.

   Règle	Faible	Plus fort
   Spécifique et familier, pas de viande mystérieuse	Ressources, Solutions, Découvrir	Guides et modèles
   Construction parallèle entre voisins	Tarifs, Pour commencer, Pour les équipes	Tarifs, Configuration, Équipes
   Mettez en avant le mot qui distingue	Paramètres du rapport, Historique du rapport	Paramètres, Historique, sous Rapports
   Une seule chose, un seul nom partout	« Équipe » dans le menu, « Personnes » sur la page	Choisissez-en un et utilisez-le dans la navigation, le titre et le fil d'Ariane
   La porte correspond à la pièce	« Forfaits » ouvre « Choisissez votre abonnement »	Le texte du lien et le titre de la page concordent
   Le texte du lien dit ce que vous obtenez	En savoir plus	Télécharger la liste de vérification d'intégration

5. Décidez ce qui arrive aux noms internes.

   Le nom est	Faites ceci
   Un nom de code d'équipe, de service ou de projet	Ne l'affichez jamais. Nommez ce que la personne est venue faire
   Un nom de marque pour une fonctionnalité que les gens doivent apprendre	Associez-le à un descripteur simple partout où il est utilisé pour la navigation
   Un terme technique que le public utilise vraiment	Gardez-le, même si des étrangers ne le connaîtraient pas, et testez-le avec ce public
   Un terme juridique ou réglementaire	Gardez le terme exact et mettez une explication simple à côté
   Un acronyme	Écrivez-le en toutes lettres, sauf si le public recherche l'acronyme plus que les mots

6. Proposez deux ou trois options pour chaque libellé contesté, avec ce que chacune gagne et perd, et recommandez-en une. Une seule réponse cache la décision.

7. Renforcez la piste autour du libellé. Les courtes descriptions, les nombres d'éléments, les fils d'Ariane et les états actifs portent ce que le mot seul ne peut pas. Lisez references/information-scent.md lorsque les libellés sont corrects isolément mais que les gens rebondissent quand même.

8. Testez la prédictibilité. Dans un sens, montrez le libellé seul et demandez ce que les gens attendent derrière ; dans l'autre, donnez un objectif et demandez quel libellé ils choisiraient. En première approche, vous pouvez faire une lecture à froid : couvrez la destination, écrivez ce que vous attendriez, comparez. Signalez cela comme votre propre lecture, pas comme une recherche. references/predictability-test.md contient le plan et la notation.

9. Vérifiez les autres langues. Si les libellés doivent être traduits, lisez references/locales.md avant de les arrêter. Traduisez pour le sens, pas mot à mot, et testez à nouveau avec des personnes sur ce marché.

Livrable

Ecrivez ces fichiers sauf si l'utilisateur en nomme d'autres.

• labels.csv, une ligne par libellé : group,label,destination,system,was,evidence,status. evidence indique d'où vient le mot (log de recherche, support, hypothèse). status est kept, renamed ou new, plus tested ou untested, séparés par un point-virgule : renamed; untested.
• labels.md, dans cet ordre : Recommandation (deux ou trois phrases) ; Le système choisi pour chaque niveau ; Libellés contestés (options, compromis, le choix et pourquoi) ; Noms internes et ce qui arrive à chacun ; Comment les tester ; Hypothèses et questions ouvertes. La liste complète ne vit que dans labels.csv, donc les deux ne peuvent pas être en désaccord.

Travail	Rendu
Renommer une chose	Trois options avec compromis, un choix et une question de test, dans la réponse
Réviser un menu	Les lignes de labels.csv et une courte liste de modifications
Tout un site ou une application	Les deux fichiers

Un document plus long n'est pas un document plus approfondi.

Vérifiez-le

Exécutez la vérification mécanique et utilisez ses comptes :

node "${CLAUDE_SKILL_DIR}/scripts/label-check.mjs" labels.csv

Il trouve les mots vagues, les doublons dans un groupe, les voisins qui commencent par le même mot, les groupes mélangeant des formes grammaticales, un seul libellé avec plusieurs destinations et une seule destination avec plusieurs libellés. La vérification formelle ne se déclenche que sur des motifs clairs, donc lisez chaque groupe vous-même pour la construction parallèle. Vérifiez ensuite :

• Chaque groupe utilise un seul système de libellés, et labels.md indique lequel.
• Chaque libellé est tested ou marqué untested. Un script propre ne prouve rien sur la compréhension.
• Chaque evidence d'un libellé est réelle. S'il s'agit d'une hypothèse, la ligne le dit.

Ce que Claude ne peut pas faire ici

Vous ne pouvez pas apprendre ce que les vraies personnes comprennent en lisant un libellé vous-même, et vous ne pouvez pas connaître la stratégie de l'organisation, les engagements de marque ou la politique sauf si on vous le dit. N'inventez jamais de chiffres d'utilisation, de volumes de recherche, de résultats de test ou de citations. Proposez des alternatives avec leurs compromis, recommandez-en une et dites pourquoi ; l'humain possède la décision, surtout lorsqu'un nom porte un poids de marque ou juridique.

Où cela passe la main

Besoin suivant	Compétence
Les groupes eux-mêmes semblent incorrects	card-sort, sitemaps
Quels libellés vont sur quel menu	navigation
Termes pour le marquage et les filtres	taxonomies
Une section renommée qui change d'adresse	url-structure, redirect-maps
Tester les libellés dans une hiérarchie	tree-tests
Renommer n'a pas résolu « les gens ne trouvent pas »	findability
Une liste de ce qui existe d'abord	content-inventory
Champs derrière un modèle	content-models
Une restructuration complète du site, ou incertitude sur où commencer	information-architecture