J'ai suivi tous les guides de style officiels et mes articles sont devenus fades

Utiliser les outils de lecture

Écouter lit l’article à voix haute. La lecture rapide affiche les groupes de mots au rythme choisi. La pratique des langues compare les traductions disponibles. Enregistrer ajoute un favori dans ce navigateur, accessible dans la liste du lecteur.

Partager cet article

Partager cet article

Publicité
Publicité

Les guides d'écriture officiels de Microsoft et de Google sont redoutables. Ils apprennent à écrire des phrases courtes, à mettre l'essentiel en premier, à harmoniser les termes, à écrire de façon facile à traduire et à rendre un texte agréable à lire pour tout le monde.

Mais un médicament puissant ne rend pas en bonne santé sous prétexte qu'on avale tout le flacon. Si vous appliquez un guide officiel de façon mécanique, comme une loi qu'il faudrait respecter à la lettre, votre article part soudain travailler au centre d'aide d'une entreprise. Le texte qui, hier encore, grommelait « mais pourquoi ça marche comme ça ? » ne sait plus dire, le lendemain matin, que « Veuillez suivre les étapes ci-dessous. » Sa personnalité est passée en comité de validation.

La conclusion est simple.

Ce qu'on emprunte aux guides officiels, c'est leur sagesse sur la structure, la clarté, l'accessibilité et l'écriture multilingue, qui sert à ne pas perdre le lecteur. Ce qu'on n'emprunte pas, c'est l'uniformisation du style quand elle ne correspond pas à la vocation de notre média.

Et il ne s'agit pas d'une crise d'adolescence contre les guides. Le guide de style de Google pour les développeurs dit lui-même d'appliquer d'abord les règles propres au projet, et qu'on peut s'écarter du guide si cela sert le lecteur.[4] Au fond, Microsoft comme Google placent au centre le fait que le lecteur comprenne facilement.[1][2][5]

La conclusion en 5 secondes : un guide est un garde-fou, pas une constitution

Pour éviter les accidents, mieux vaut répartir l'usage d'un guide officiel en trois couches.

Couche Rôle Exemples
Exigences obligatoires Ce qu'il faut respecter : lois, normes, spécifications officielles Exigences formelles d'accessibilité, noms exacts des produits, citations et sources
Recommandations fortes Principes qui améliorent beaucoup la lisibilité Conclusion en premier, intertitres qui structurent le fil, paragraphes courts, termes harmonisés
La saveur du média Ce qu'on conçoit selon le site, l'auteur et les lecteurs Humour, métaphores, piques, rythme, tournures de fin de phrase, running gags

Les ennuis commencent dès qu'on transforme ces trois couches en « règles absolues ».

Par exemple, le guide de Google pour les développeurs conseille d'éviter les expressions idiomatiques et l'humour liés à une culture dans les documents techniques destinés au monde entier.[5] Pour un document qui explique comment configurer une API et qui sera traduit en 12 langues, c'est tout à fait sensé.

Mais ce n'est pas une raison pour transformer une critique de restaurant, un carnet de voyage, un récit de partie de jeu vidéo, un essai ou un texte d'observation en « Interdit de rire : 24 heures de documentation technique ».

Importer des règles sans regarder leur champ d'application, c'est risquer de construire la mauvaise machine avec de très bonnes pièces.

Pourquoi appliquer le guide officiel tel quel rend facilement le texte fade

La consigne de Microsoft sur les textes faciles à parcourir recommande de placer l'information importante en premier, d'utiliser des titres, des phrases et des paragraphes courts, et de prévoir un moyen de s'orienter dans les longs textes.[1] Sa consigne d'accessibilité valorise elle aussi les textes courts, porteurs de sens et ciblés.[2]

Jusque-là, c'est très solide.

Mais dès qu'on automatise et qu'on se met à noter selon des règles comme « plus c'est court, mieux c'est », « supprimer les métaphores », « supprimer les mots d'émotion », « supprimer l'oral », tout se casse.

On finit avec trop de phrases courtes.

Et alors.

Le texte.

Devient ça.

On voulait faciliter la lecture, et c'est un robot qui nous envoie des télégrammes.

À l'inverse, si l'on uniformise complètement tous les paragraphes en « conclusion, raison, exemple », les premiers articles font du bien, mais au millième, le lecteur peut prédire l'avenir. La cohérence dans la conception de l'information est nécessaire ; la mise en scène, elle, n'a pas besoin d'être identique.

Rendre un texte lisible, ce n'est pas lui retirer sa personnalité.

C'est réduire l'effort inutile que le lecteur doit fournir pour saisir le sens.

Ce que disent vraiment Microsoft et Google

Si l'on résume les guides officiels, leur point commun est étonnamment simple.

Microsoft pousse fort ce qu'on pourrait appeler la « prévention de l'égarement » : mettre l'important en premier, écrire court et clair, ajouter de la navigation aux longs textes, garder une structure cohérente.[1] En accessibilité, il valorise aussi les phrases courtes et porteuses de sens, et la structure.[2] Pour les contenus mondiaux, il dit que des phrases courtes et simples et une terminologie cohérente facilitent la traduction.[3]

Le guide de Google pour les développeurs recommande lui aussi une écriture claire, concise, sans ambiguïté, des explications directes et une terminologie cohérente.[5] Mais tout en haut de ce même guide, il est écrit qu'on utilise d'abord le style propre au projet et qu'on peut s'écarter du guide si le contenu y gagne.[4]

Du côté de la recherche, Google se soucie moins de savoir si le texte a l'air d'être « dans le style Google » que de l'information originale, de l'analyse originale, d'explications suffisantes, de l'expérience de première main et d'un contenu qui permet au lecteur d'atteindre son but.[6] Ses consignes de 2026 pour la recherche par IA générative mettent elles aussi en avant un point de vue propre et « un contenu qui ne soit pas de la généralité que n'importe qui pourrait produire », et non un réchauffé de l'existant.[7]

Autrement dit, si l'on met bout à bout tous les documents officiels, cela donne ceci :

Soyez lisible. Soyez exact. Aidez le lecteur. Et ne devenez pas une photocopieuse.

Une exigence assez humaine.

Ne faites pas passer des chiffres inventés pour des « normes Google »

Ce qu'il y a de plus dangereux dans l'automatisation de l'écriture, c'est de promouvoir au rang d'oracle des chiffres que les guides officiels ne mentionnent pas.

« Une phrase doit faire moins de 20 caractères, c'est la norme Google. » « Au-delà de 2000 caractères, c'est meilleur pour le SEO. » « Il faut exactement tant d'intertitres. » « Le taux de jargon doit rester sous tant de pour cent. »

Ces chiffres peuvent servir de seuils d'alerte internes. Mais si les sources officielles ne le disent pas, on n'a pas le droit de parler d'« exigence de Google » ni d'« exigence de Microsoft ».

D'ailleurs, les consignes de Google Search sur les contenus conçus pour les gens suggèrent justement de se demander si l'on calibre son texte sur un nombre de mots parce qu'on croit que Google le préfère, et affirment clairement qu'il n'existe pas de nombre de mots préféré.[6]

C'est pourquoi, dans les contrôles automatiques, on répartit les verdicts en trois types :

  1. Exigences officielles obligatoires : on les rend obligatoires, source à l'appui.
  2. Recommandations officielles : on en fait des avertissements ou des pistes d'amélioration.
  3. Nos règles empiriques : on les signale comme règles internes, sans emprunter l'étiquette officielle.

N'habillez pas vos règles maison avec l'uniforme de Google. Rien que ça, c'est déjà beaucoup plus sain.

Une conception en trois couches pour concilier lisibilité et plaisir

Le texte d'un article se manipule mieux quand on le divise en trois couches.

1. L'ossature du sens

Faits, conclusions, chiffres, dates, conditions, citations, sources, incertitude.

Ici, on ne plaisante pas. Si, dans un guide de jeu, les dégâts sont de 3, on n'écrit pas 30 pour que ce soit drôle. Le monde s'effondre avant le rire.

2. Le chemin vers la compréhension

Titres, résumés, ordre, paragraphes, tableaux, exemples concrets, explications des termes, liens internes.

C'est ici qu'on déverse à pleines mains la sagesse de Microsoft et de Google. Le but est que le lecteur ne se retrouve jamais à se demander « où suis-je ? » ou « bref, de quoi s'agit-il ? ».

3. La voix de l'article

Métaphores, blagues, piques, observations, rythme, tournures, exemples bizarres.

Si l'on coupe tout cela, l'information est peut-être juste, mais il n'y a plus de raison de la lire précisément sur ce site.

L'essentiel, c'est que la couche 3 ne casse pas la couche 1.

Une mauvaise blague cache le sens. Une bonne blague aide à retenir le sens.

Par exemple, « La triple gestion est importante » reste faible.

Mais si l'on dit « La mémoire seule, c'est une philosophie ; GitHub seul, c'est une constitution ; le planning seul, c'est un ouvrier. C'est quand les trois sont reliés que ça devient une usine », on retient aussi la différence entre les rôles.

La blague porte une partie des bagages de l'explication. Là, elle travaille.

En 12 langues, on ne traduit pas la blague : on traduit le travail de la blague

Ce qui se casse le plus facilement en écriture multilingue, c'est l'humour, pas les faits.

La phrase japonaise « l'article est parti travailler au centre d'aide » peut survivre à une traduction mécanique en anglais. Mais les jeux de mots, les mèmes d'internet, les blagues de fin de phrase et les références culturelles ont un taux d'accident élevé.

Si le guide de Google pour la documentation technique mondiale évite les expressions et l'humour liés à une culture, c'est justement pour réduire ces accidents de traduction.[5]

Cependant, pour un article grand public, la solution n'est pas simplement de « retirer le rire de toutes les langues ».

Il faut séparer le sens et la fonction de la blague.

Si la blague de la version japonaise sert à détendre la tension d'une explication raide, il faut en anglais une petite pique qui sonne naturelle en anglais. En coréen, créer une pause naturelle en coréen. Même chose pour le chinois, l'espagnol, le portugais, l'indonésien, le thaï, le vietnamien, le français et l'allemand.

Ce qu'on fige : faits, chiffres, logique, sources, incertitude.

Ce qu'on peut régénérer : ordre des mots, métaphores, accroches, comparaisons, blagues, rythme de l'explication.

Douze langues, ce n'est pas tant « convertir le japonais onze fois » que « bien écrire douze fois le même article ».

Plus qu'une usine de traduction, c'est une réunion de douze rédacteurs. Une réunion qui sert vraiment à quelque chose. C'est rare.

Les règles se répartissent en trois endroits : mémoire, source de référence et consignes d'exécution

Dans une usine d'articles automatisée, avoir fixé une bonne règle une fois ne permet pas de se reposer.

Un humain peut dire « ce que je t'ai dit l'autre fois » et être compris. Un traitement automatique, lui, fait mine de tout avoir oublié à l'exécution suivante.

On répartit donc en trois.

Où Rôle Ce qu'on y met
Mémoire L'intention éditoriale à long terme Pourquoi cette politique, et ce qu'il ne faut pas casser
Source de référence (GitHub, etc.) Les règles officielles détaillées Critères de décision, exemples, champ d'application, historique des modifications
Planning et consignes d'exécution L'action à chaque fois Lire la dernière source de référence avant d'exécuter ; ne pas privilégier d'anciennes règles figées

Le point important est de ne pas copier-coller la même longue règle aux trois endroits et de finir avec trois sources de référence.

Avec trois sources, la semaine suivante, les trois disent des choses différentes. Ce n'est pas la technique du clonage, c'est la guerre civile.

La source de référence des règles détaillées est concentrée en un seul endroit. La mémoire garde l'intention, et le planning contient un contrat d'exécution qui dit « lisez la dernière source de référence ».

Ainsi, la philosophie d'écriture, la spécification officielle et chaque exécution sont reliées.

Le contrôle automatique doit aussi vérifier qu'on n'a pas « effacé la personnalité »

Les contrôles de texte classiques examinent les fautes de frappe, la longueur des phrases, les titres, les liens et les sources.

Si l'on ne vérifie que cela, après cent tours d'amélioration de la qualité, tous les articles peuvent finir avec le même visage.

Il faut donc ajouter aussi ces points au contrôle :

  • Saisit-on la conclusion tout de suite ?
  • Le fil se comprend-il avec les seuls titres H2 ?
  • Le sens passe-t-il même si l'on ne connaît pas les termes techniques ?
  • Les sources, les chiffres et l'incertitude n'ont-ils pas été abîmés ?
  • Les observations, comparaisons, analyses et expériences originales sont-elles toujours là ?
  • A-t-on coupé sans nécessité des blagues efficaces ou de la chaleur présentes dans l'original ?
  • Le texte corrigé a-t-il dégénéré en « résumé d'IA » qu'on trouve partout ?
  • A-t-on traduit mot à mot la même blague en 12 langues, au risque de l'accident ?
  • Fait-on passer pour une « obligation officielle » un seuil qui ne figure pas dans les guides officiels ?

La politique anti-spam de Google Search vise les pages produites en masse avec de l'IA générative, de la traduction ou de la reformulation, qui n'apportent presque aucune valeur à l'utilisateur.[8]

Autrement dit, « la grammaire est correcte » n'est que le minimum.

Il faut vérifier qu'après correction, on n'a pas aussi effacé la raison de lire.

Exemples d'échecs : ce que font souvent les robots d'amélioration de texte

Échec 1 : tout raccourcir

On découpe toutes les phrases longues et on casse du même coup les liens de sens. La solution est de regarder non pas la « brièveté », mais si les relations se comprennent en une seule lecture.

Échec 2 : tout mettre dans la même syntaxe

On fige chaque paragraphe dans le même ordre et le même rythme. La solution est d'ordonner l'information sans mettre le rythme en uniforme.

Échec 3 : traiter l'humour comme du bruit

On supprime toutes les métaphores et toutes les piques. La solution est de garder les blagues qui aident à comprendre et de couper seulement les digressions gênantes.

Échec 4 : croire qu'écrire à la manière de Google, c'est du SEO

On confond le style de la documentation pour développeurs et la qualité de recherche. La solution est de traiter guide de style, qualité de recherche, accessibilité et localisation comme des couches distinctes.

Échec 5 : inventer des chiffres

On appelle « norme Google » une valeur absente de toute source. La solution est de dire qu'il s'agit d'une heuristique interne, quand c'en est une.

Liste finale : rendez le texte lisible, sans mettre l'humain en rupture de stock

  • Le sujet et la conclusion se saisissent en 5 secondes.
  • On saisit le tableau d'ensemble en 30 secondes.
  • Le fil se comprend avec les seuls H2.
  • On comprend avec des mots ordinaires.
  • Les noms officiels, les chiffres et les sources sont exacts.
  • Même long, le texte ne perd pas le lecteur.
  • Il y a une valeur originale.
  • Les blagues aident l'explication.
  • Les blagues n'abîment pas les faits.
  • La fonction des blagues est localisée dans les 12 langues.
  • On ne mélange pas obligation officielle, recommandation officielle et règles internes.
  • Même après les corrections automatiques, il reste une raison de le lire sur ce site.

Les guides officiels sont redoutables. C'est précisément pour cela qu'il ne faut pas les avaler tout rond.

À Microsoft, empruntez la conception qui ne perd personne. Au guide de documentation de Google, empruntez la clarté et la conception pour un public mondial. À Google Search, empruntez le contenu pensé pour les gens, la valeur originale et la confiance.

Et la voix du site, gardez-la pour vous.

Améliorer la qualité d'un texte, ce n'est pas lui mettre un uniforme. C'est n'arranger que les endroits où le lecteur se perd, et laisser en place ceux où le plaisir fait son travail.

Il faut des garde-fous. Mais si l'on transforme toute la route en garde-fou, on ne peut plus rouler.


À lire aujourd’hui

Chacun répond à une question que se posent souvent les lecteurs de cet article.

Voir tous les articlesPlus sur Communication

Partager cet article

Publicité

Encore un ? Un truc sympa ?

Puisque vous avez fini : quelques histoires proches et d'autres complètement différentes, mais amusantes.

  1. Sujet prochePourquoi tout le monde me tutoiela familiarité dans le service
  2. Pyra/Mythrapourquoi toutes mes attaques perdent
  3. Rien à voir, mais amusantLa vengeance ne vous sauve pasHanzawa Naoki et les jeux de statut
  4. Qu’est-ce que le « Takeshimansion » de l’aquarium Takeshima?Un nom qui rend un bassin amusant
  5. Pourquoi les personnages de Chiikawa mangent-ils sans cesse?Nourriture, herbes, monstres, travail et classement 10+
  6. Hisoka est un pervers, mais aussi un excellent mentorl'arc Greed Island

Trouver d’autres articles

Tous les articles

Mendoi-chan

Qui tient ce site

Mendoi-chan

Elle transforme les frictions du travail et du quotidien en structures claires et en prochaines étapes concrètes.

Publicité

Articles récents

  1. 1Si personne ne lit votre article jusqu'au bout, ne mettez pas le texte en sandwich de pubs : vendre l'espace vide sur les côtés de l'écran d'ordinateur avec Adsterra
  2. 2À l'ère de l'IA, être intelligent, c'est savoir quoi demander, pas avoir la réponse
  3. 3En une semaine, mon système d'articles par IA est devenu une « usine autonome »
  4. 4J'ai demandé à l'IA « au fond, c'est pour quoi faire ? » : elle est devenue philosophe au lieu de réparateur
  5. 5L'usine était prête avant les 1 500 articles : que se passe-t-il quand explorer, structurer, améliorer et automatiser se cumulent grâce à l'IA
Publicité