Guide de style

Un guide de style est un ensemble de normes documentées qui régissent la production d'un document, qu'il s'agisse d'éléments visuels, de langage écrit ou des deux. Les guides visuels précisent la typographie, les couleurs, l'espacement, le traitement des images et l'utilisation du logo ; les guides de contenu précisent le ton, la terminologie, la mise en majuscules, les conventions de formatage et la manière de gérer les cas récurrents tels que les dates, les nombres et les messages d'erreur.

Son objectif est de garantir la cohérence sans avoir à remettre en question chaque décision. En l'absence de normes documentées, chaque nouvelle page, campagne ou écran est conçu selon le jugement de son concepteur, et une organisation se retrouve avec une douzaine de versions légèrement différentes d'un même élément. Le coût se traduit par une incohérence visuelle, une terminologie incohérente qui déroute les clients et un temps perdu à débattre de décisions prises il y a des années.

Les guides les plus utiles sont prescriptifs et précis, plutôt que descriptifs et idéalistes. Affirmer que le ton de la marque est à la fois convivial et professionnel n'apporte aucune aide à la rédaction d'un message d'erreur. Un guide présentant les formulations privilégiées et rejetées dans les situations courantes, avec justification, est directement applicable. Le critère de réussite est la capacité d'un nouveau contributeur à produire un travail conforme à partir du seul document.

Les décisions terminologiques constituent souvent le contenu le plus précieux et le plus négligé. Définir la dénomination de chaque produit, fonctionnalité et processus au sein de l'organisation, et consigner les alternatives à éviter, permet d'éviter que les services marketing, produit, support et documentation n'utilisent des termes différents pour désigner une même chose. Face à trois appellations différentes pour un même concept, les clients peuvent légitimement en déduire qu'il s'agit de trois choses distinctes.

Les guides échouent principalement par manque d'application plutôt que par un contenu de mauvaise qualité. Un document rédigé, diffusé puis oublié est rapidement supplanté par des pratiques incohérentes, et la version réellement suivie devient celle du dernier document similaire. Parmi les mécanismes d'application efficaces, on peut citer l'intégration des règles dans les outils, comme l'analyse statique du code pour les normes de contenu, et la limitation des choix dans la conception et les bibliothèques de composants, ce qui facilite la mise en conformité.

La mise à jour du guide est essentielle pour garantir sa pertinence. Les normes obsolètes sont ignorées de manière sélective, et une application sélective se transforme en non-conformité généralisée. L'attribution de la responsabilité, la mise en place d'une procédure de proposition de modifications et une révision périodique permettent de maintenir le document à jour, tandis que la documentation des justifications des décisions empêche leur remise en cause arbitraire par une personne ignorant leur raisonnement.

Le périmètre du guide doit correspondre aux capacités de gestion réalistes de l'organisation. Les guides exhaustifs, couvrant tous les cas de figure possibles, deviennent tellement volumineux que personne ne les lit et tellement obsolètes que personne ne leur fait confiance. Un guide concis, traitant des décisions courantes et complété uniquement en cas d'ambiguïté récurrente, reste à jour et utilisé. C'est la rigueur consistant à ne pas documenter les cas exceptionnels qui garantit sa pertinence.

Il est important de distinguer la relation avec un système de conception. Un guide de style documente les décisions et les règles ; un système de conception fournit des composants implémentés qui les incarnent. Un guide seul repose sur la lecture et l’application par les utilisateurs, tandis que les composants appliquent automatiquement la norme partout où ils sont utilisés. Lorsque les deux existent, le guide couvre ce que les composants ne peuvent pas, notamment le ton, la terminologie et les décisions nécessitant un jugement.

Comme la valeur réside dans l'adoption plutôt que dans la documentation, les efforts consacrés aux mécanismes d'application sont généralement plus rentables que ceux consacrés à l'extension du guide. En pratique, les normes visuelles et de composants sont établies au sein de la conception des produits et intégrées au système de conception, les normes linguistiques et terminologiques sont convenues avec services de marketing afin que le vocabulaire destiné aux clients soit cohérent pour l'ensemble du produit et sa promotion, et que la propriété en incombe généralement au Département UX là où il en existe une.