Guide de style du contenu produit
Cette compétence ancre les décisions de contenu GUI dans le guide de style du contenu produit de Bitwarden. Appliquez-la uniquement aux chaînes visibles par l'utilisateur final — libellés de boutons, messages d'erreur, notifications, modales, flux d'onboarding, états vides, libellés de formulaires, texte d'aide, texte de lien, et similaire. Ne l'appliquez pas aux tokens de design, commentaires de code, chaînes internes/destinées aux développeurs, ou contenu marketing.
En cas de doute sur un cas spécifique, demandez avant de modifier le contenu.
Voix et ton
La voix est constante. Le ton s'adapte au contexte.
La voix produit est bienveillante, encourageante et transparente — cohérente sur toutes les plateformes.
Le ton transmet une ambiance et dépend de qui vous parlez et ce qui se passe. La sécurité est une affaire sérieuse. Les utilisateurs ne cherchent pas l'humour ou du remplissage — ils veulent savoir que leurs informations sont en sécurité. Le ton produit de Bitwarden est donc presque toujours sérieux et respectueux.
Spectres de ton :
- Décontracté ↔ formel
- Enthousiaste ↔ neutre
Où les types de contenu courants se situent sur la carte des tons (axes : décontracté ↔ formel × neutre ↔ enthousiaste) :
| Type de contenu | Décontracté / Formel | Neutre / Enthousiaste |
|---|---|---|
| Messages de succès | Décontracté | Enthousiaste |
| Contenu onboarding | Décontracté | Enthousiaste |
| Dialogues | Décontracté | Neutre |
| États vides | Décontracté | Neutre (légèrement) |
| Libellés | Neutre | Neutre |
| Communauté | Formel | Enthousiaste |
| Confirmations | Formel | Neutre |
| Articles d'aide | Formel (légèrement) | Neutre |
| Avertissements | Formel | Neutre |
| États d'erreur | Formel | Neutre |
Exemples
Message d'erreur — formel, neutre :
- Bon : Une erreur s'est produite. Veuillez réessayer.
- À éviter : Oups ! C'est nous qui avons dérapé. Allez-y et rafraîchissez !
Message d'onboarding — décontracté, enthousiaste :
- Bon : Salut ! 👋 Bienvenue dans Bitwarden. On va te montrer le tour !
- À éviter : C'est ton coffre-fort. Commençons maintenant.
Appliquer cette compétence
Lors d'une critique explicite de contenu (« examiné ce contenu », « ce message d'erreur est-il correct ») :
- Identifiez le type de contenu (erreur, onboarding, bouton, etc.) et le ton attendu en utilisant la carte des tons ci-dessus.
- Vérifiez la cohérence de la voix (bienveillante, encourageante, transparente).
- Parcourez les règles de grammaire et de mécanique pertinentes pour l'extrait — voir
references/grammar-mechanics.md. - Parcourez les règles d'accessibilité pertinentes pour l'extrait — voir
references/accessibility-rules.md. - Retournez des réécritures spécifiques et actionnables — pas juste « c'est faux ».
À l'intérieur des exécutions figma-to-angular (compétence externe dans le repository clients, non incluse ici) :
Lorsque la conception Figma comprend des chaînes de contenu, validez-les par rapport à ce guide avant de les émettre dans le template Angular. Si une chaîne viole clairement une règle (par ex., bouton en casse titre, ampersand, lien « Cliquez ici »), soulevez le problème et proposez une alternative conforme — ne réécrivez pas silencieusement. Demandez à l'utilisateur laquelle utiliser.
À l'intérieur des critiques d'examen de conception :
Si l'étape est à 60 % ou 90 %, incluez des observations de contenu aux côtés des retours visuels (90 % est le bon moment pour « les détails de grammaire, la finalisation du contenu »). Ignorez les critiques de contenu à 30 % — le contenu changera. Formulez les retours de contenu de la même manière que les retours visuels : liés aux objectifs utilisateur/produit, non au goût personnel.
Format de sortie pour la critique de contenu
- Type de contenu et ton attendu — nommez ce que cette chaîne est et où elle devrait se situer sur le spectre des tons.
- Ce qui fonctionne — ce qu'il faut conserver.
- Problèmes — chacun lié à une règle spécifique de ce guide (citez le nom de la section, en incluant le fichier de référence si la règle s'y trouve).
- Réécriture(s) proposée(s) — alternatives concrètes parmi lesquelles l'utilisateur peut choisir.
Gardez la critique spécifique. « Le bouton utilise la casse titre ; casse de phrase selon references/grammar-mechanics.md (Majuscules) » vaut mieux que « la majuscule n'est pas correcte ».
Ressources supplémentaires
Les règles détaillées se trouvent dans deux fichiers de référence. Chargez-les quand la critique en a besoin — la plupart des problèmes de contenu ne touchent qu'une ou deux règles.
references/grammar-mechanics.md— Acronymes, ampersands, majuscules (casse de phrase, noms de produits, fonctionnalités, minuscules pour les objets), dates et mois, jours de la semaine, par ex. / c.-à-d., points de suspension, tailles et formats de fichiers, argent, nombres, virgule Oxford, heures et fuseaux horaires, versus.references/accessibility-rules.md— Niveau de lecture et directivité, mises en page scannables, considérations non-anglaises et ESL, épellation des acronymes, éviter les encadrements « facile » et « simple », style de texte, langage spatial, texte alternatif, texte de lien significatif, pronoms neutres du genre.