Écrire la Science avec Clarté

Que fait Écrire la Science avec Clarté ?

Cette compétence distille quatre ouvrages sur l'écriture : Strunk, The Elements of Style (1918/1920) ; Zinsser, On Writing Well (éd. 2001) ; Alley, The Craft of Scientific Writing (4e éd., 2018) ; et Heard, The Scientist's Guide to Writing (2016). Chaque règle dans les fichiers de référence provient de l'un d'eux, avec le nom de l'auteur, afin que vous puissiez la soupeser et que le lecteur puisse la vérifier. Les livres s'accordent sur l'objectif : une prose si claire que le lecteur ne la remarque jamais. Heard appelle cela la télépathie. La loi d'Alley est celle d'Einstein : aussi simple que possible, mais pas plus simple. La méthode de Zinsser est la soustraction. Celle de Strunk est « omettez les mots inutiles ».

Quatre principes auxquels chaque règle sert

1. L'effort du lecteur est la seule mesure. Si le lecteur est perdu, l'écrivain n'a pas été assez soigneux (Zinsser). Tranchez chaque question de métier en demandant quel choix permet au lecteur de comprendre l'histoire plus facilement (Heard). Analysez qui lit, pourquoi, et ce qu'ils savent déjà avant de choisir un mot (Alley).
2. Dites ce que vous voulez dire et rien de ce que vous ne voulez pas dire. La précision et la clarté s'opposent ; la complexité inutile est l'échec le plus courant dans la prose scientifique (Alley). Atténuez exactement selon les preuves, et n'enfler rien (Heard, Alley).
3. Chaque mot gagne sa place. Une phrase ne doit contenir aucun mot inutile, un paragraphe aucune phrase inutile (Strunk). La plupart des premières ébauches peuvent perdre la moitié de leurs mots sans perdre d'information (Zinsser). Forcez chaque caractère à se justifier (Heard).
4. Fait et déduction, à la suite. L'écriture scientifique est une phrase après l'autre, et le « après » est ce qui la rend difficile (Zinsser). Une idée par phrase, acteur à côté de l'action, la nouvelle information à la fin (Alley, Heard, Strunk).

Les raisons derrière les règles importent plus que les règles. Quand une règle et l'intérêt du lecteur sont en conflit, le lecteur gagne, et les fichiers de référence expliquent pourquoi chaque règle existe afin que vous puissiez juger de l'exception.

Commencez ici, à chaque fois

1. Nommez le mode. Rédiger (produire un nouveau texte), Réviser (réécrire le texte fourni), Diagnostiquer (classer ce qui ne va pas, sans réécriture), ou Planifier (concevoir le document avant la rédaction). Choisissez celui que la demande implique ; dites lequel vous avez choisi seulement si ce n'était pas clair.
2. Fixez le public, le but, l'occasion (Alley). Qui lit ceci, pourquoi, ce qu'ils savent, et ce que le support permet en longueur et en forme. Une limite de page d'une revue donne à une affirmation une phrase de justification ; un rapport ou un chapitre lui donne un paragraphe.
3. Chargez ce dont vous avez besoin, et seulement cela. references/house-style.md d'abord, à chaque fois (il est court) : il contient les préférences permanentes de l'auteur, avec un ensemble de démarrage que l'auteur peut modifier. Ensuite les fichiers dont le mode a besoin, à partir de la liste de lecture dans la carte de référence ci-dessous. Les fichiers portent des tables des matières ; lisez les sections que la tâche touche, pas chaque fichier de bout en bout.
4. Exécutez le script de signaux au maximum deux fois : une fois sur tout texte fourni plus long qu'un paragraphe, avant de lire attentivement, et une fois sur votre texte final avant de le livrer : python3 scripts/prose_signals.py <fichier> (ou --json). Il rapporte les longueurs de phrases, les candidats passifs, les ouvreurs explétifs, les nominalisations, les phrases de remplissage, les atténuateurs, les intensificateurs, les « ceci » en début de phrase sans référence, les chaînes de noms, les tirets cadratins et les acronymes à usage unique. L'en-tête dit ce que c'est : des signaux, pas des verdicts. Utilisez-le pour décider où regarder d'abord, puis lisez.
5. Décidez de ce qui ne doit pas changer. Les nombres, les affirmations, les citations, les termes définis, et, lorsque le texte est celui de l'auteur, les tournants de l'argumentation et la voix que le fichier de style maison protège. N'inventez jamais un nombre, une citation, un résultat ou une affirmation que la source ne contient pas. Marquez un vide par ??? et listez-le.

Mode : Rédiger

Rédaction à partir de notes, d'un plan ou de résultats.

1. Trouvez d'abord l'histoire. Écrivez le mini-résumé en deux phrases : la question centrale et sa réponse (Heard). Cela détermine ce qui appartient : est-ce qu'inclure cela aiderait à raconter l'histoire ou en distrairait-il ? Pour une section de livre, énoncez la question du lecteur à laquelle la section répond et que le chapitre ne répond pas déjà (style maison). Si les notes ne portent pas de réponse, l'histoire est la question plus la conception, et vous le dites.
2. Prenez le squelette dans references/structure.md. Une introduction passe du territoire à l'écart à ce que ce travail fait, et se termine sur la question, l'approche et le résultat principal (Heard) ; l'ampleur de l'ouverture est fixée par le support. Un résumé est un résumé informatif qui donne le résultat (Alley, Heard). Une discussion répond à la question dans son premier paragraphe et se termine sur la découverte la plus importante et sa signification (Heard). Un chapitre s'ouvre sur une phrase d'orientation et cartographie ses sections (Alley, style maison).
3. Décidez des unités avant d'écrire (Zinsser) : le pronom, le temps, le ton. Tenez-les jusqu'à la fin.
4. Rédigez vite, puis révisez dans l'ordre. Débarquez sur la plage avec une ébauche complète, des espaces réservés pour tout ce qui manque (Heard). Ensuite, exécutez les cycles de Révision ci-dessous sur votre propre ébauche avant de livrer. Le lecteur ne voit que l'ébauche révisée.
5. N'écrivez que ce que les sources soutiennent, et gardez les vides hors du texte prêt à coller. N'ajoutez pas une affirmation, un mécanisme ou une conséquence que les notes ne contiennent pas, même pour combler un argument (« planter de la végétation peut rafraîchir un quartier mais ne peut pas augmenter ses revenus » est une affirmation, pas une transition). Combler avec les propres faits des notes, ou laissez la couture et signalez le vide dans la note ; divulguer une affirmation ajoutée ne la rend pas admissible. Lorsque les notes ne contiennent pas de résultat principal, terminez une introduction sur la question et l'approche (l'ordre que Heard nomme comme alternative) plutôt que sur un espace réservé ; la note dit ce qu'une phrase de résultat finale ajouterait. Une affirmation de priorité (« le premier à tester ») conserve son qualificatif (« à notre connaissance »), parce que la recherche documentaire est ce que l'analyse ne peut pas trancher (style maison : atténuez ce qui reste véritablement non résolu).
6. Livrez le texte sous la forme demandée (prêt à coller pour le texte de manuscrit ; voir Formats de sortie) plus une courte note listant les vides, les hypothèses et les un ou deux choix que l'auteur pourrait vouloir inverser (par exemple « l'ébauche se termine sur la conception ; si vous voulez qu'elle se termine sur le résultat principal, ajoutez une phrase : … »).

Mode : Réviser

Resserrement ou clarification du texte fourni par l'utilisateur. C'est le mode qu'appelle le « ça se lit mal » d'un co-auteur.

1. Lisez l'ensemble du passage une fois pour son histoire et l'intention de l'auteur avant de toucher à un mot. Notez les non-négociables de « Commencez ici ».
2. Choisissez l'ampleur de la modification à partir de la demande, et dites laquelle vous avez choisie. Trois cas :
   • Une demande de corriger une phrase, ou un chapitre que l'auteur a terminé : révisez la phrase ou l'expression exacte, et ne rapportez que les erreurs factuelles ou scientifiques ailleurs (style maison).
   • Une demande de renforcer, d'améliorer ou de faire en sorte qu'un passage se lise bien, y compris le texte propre de l'auteur : faites les trois choses suivantes, et rapportez chacune. D'abord, le test de valeur : nommez toute phrase qui ne porte pas d'affirmation (une auto-annonce telle que « Ce chapitre expose pourquoi… », un récapitulatif, une réserve qui ne change aucune affirmation, une carte de chapitre à l'intérieur d'un résumé) et proposez sa suppression comme un élément réversible, avec la phrase citée et la raison ; si vous conservez une telle phrase, dites pourquoi. Ensuite, le mouvement structurel qui aiderait le plus (une phrase déplacée là où sa conséquence suit, une découverte enfouie ramenée en avant, quatre phrases parallèles pliées en une seule), proposé de la même manière. Troisièmement, les réparations de phrases : un connecteur ambigu (« depuis » pour « parce que »), un pronom ou « ceux-ci » sans référent clair, un verbe figuratif, une phrase redoublée se trouvant maintenant dans des phrases adjacentes. « Gardez chaque affirmation et chaque terme exactement » interdit les nouvelles affirmations et les termes renommés ; il n'interdit pas ces réparations, qui ne changent aucune affirmation. Ne réécrivez jamais un paragraphe entier pour le seul style, et conservez la voix, les termes et les affirmations de l'auteur.
   • Une demande de resserrer une ébauche : la réécriture est autorisée, mais chaque fait, nombre, terme et citation survivent inchangés. Une véritable révision de cette compétence a rendu explicite le cas intermédiaire : invité à fournir un résumé « fort », l'auteur a préféré la révision qui déplaçait une phrase à celle qui changeait trois phrases et laissait la structure inchangée.
3. Révisez en cycles à objectif unique, dans cet ordre (Heard, Alley), car vous ne devriez jamais polir ce que vous êtes sur le point de couper :
   • Contenu : coupez ce qui ne sert pas le travail du passage ; vérifiez que l'affirmation correspond aux preuves ; ne conservez que les atténuations dont les preuves ont besoin.
   • Structure et paragraphes : un point par paragraphe, annoncé tôt ; chaque phrase commence d'une manière qui se connecte à la précédente ; l'élément nouveau et important se trouve à la fin de la phrase et du paragraphe (references/paragraphs.md).
   • Phrases : acteur à côté de l'action, verbe tôt, une idée par phrase, actif sauf si le passif fait l'un de ses trois travaux, pas de « ceci » nu, pas de modificateur mal attaché, pas de pronom ambigu (references/sentences.md).
   • Mots : phrases de remplissage, nominalisations, intensificateurs, atténuations empilées, jargon que le lecteur ne possède pas, nombres rapportés avec une précision inutile (references/words.md). Une abréviation utilisée une fois dans le passage est écrite en toutes lettres dans le texte lui-même, pas laissée en place avec une note ; si elle réapparaît plus tard dans le document, dites-le dans la note et conservez la définition.
   • Mécanique : virgules après les phrases introductives, virgules en série, pas de tirets cadratins, temps cohérent dans la section, acronymes définis une fois.
4. Simulez le lecteur (Heard). Lisez la révision comme un étranger qui n'a que les mots. Lisez-la à voix haute dans votre tête pour les liens entre les phrases (Zinsser).
5. Vérifiez que rien n'a dérivé. Chaque nombre, unité, intervalle, citation et terme défini est identique à la source. Les affirmations ne sont ni plus fortes ni plus faibles que la source ne les a faites, sauf si l'utilisateur a demandé ce changement.
6. Livrez le texte prêt à coller, une liste de modifications et, lorsque vous coupez des phrases, une liste de coupes (voir Formats de sortie).

Mode : Diagnostiquer

Résultats classés sans réécriture. Également le mode pour « pourquoi ceci est-il faux ? » et « dois-je utiliser le passif ici ? » : nommez la règle, l'auteur, la raison et un exemple avant-après tiré des fichiers de référence.

1. Exécutez le script ; lisez en tant que lecteur visé ; gardez l'histoire de l'ensemble du document en vue.
2. Classez les résultats par leur coût pour le lecteur, le fond avant la mécanique : l'histoire et l'affirmation (une affirmation excessive, une limite manquante, une preuve qui ne soutient pas l'interprétation, un résultat principal enfoui) d'abord ; la structure (ordre, positions de puissance, liens manquants, un récapitulatif là où devrait être une fin) en deuxième ; les paragraphes en troisième ; les phrases en quatrième ; les mots en cinquième ; la mécanique en dernier.
3. Écrivez chaque résultat en une forme : citez les mots incriminés (cinq à douze d'entre eux), dites ce qui ne va pas pour le lecteur, nommez le principe et son auteur, et dites ce qu'une correction ferait. Regroupez les défauts mécaniques répétés en un seul résultat avec un décompte.
4. Gardez l'ensemble du diagnostic à environ 800 à 1 200 mots pour une section, et au maximum douze résultats. Les trois à cinq résultats qui portent sur le fond reçoivent un paragraphe chacun ; les autres reçoivent une ligne avec un décompte et une instance citée. Un lecteur qui doit parcourir deux mille mots de résultats n'agira sur aucun d'eux. Réduisez la longueur à partir des résultats mécaniques, jamais à partir d'une capture substantielle : un terme qui dérive entre ce qui a été mesuré et ce qui est affirmé (proximité mesurée, « pollution atmosphérique » affirmée), une affirmation faite à deux forces, un résultat enfoui. Un acronyme que la section ne définit jamais est toujours un résultat d'une ligne.
5. Ne réécrivez pas à moins qu'on vous le demande. Si un principe n'est pas clair sans exemple, montrez une phrase révisée, étiquetée comme illustration.
6. Terminez par les deux ou trois changements qui importeraient le plus, dans l'ordre.

Mode : Planifier

Concevoir un article, une proposition, un chapitre ou une section avant la rédaction.

1. Public, but, occasion, support et budget de longueur (Alley).
2. Le mini-résumé en deux phrases, puis la ligne de vente : pourquoi la question importe à ce lecteur, pas à l'auteur (Heard). Rejetez les cadres timides (« aucune étude n'a rapporté »).
3. Mélangez d'abord les figures et les tableaux ; laissez la question être implicite dans les réponses qu'ils donnent (Heard). Soyez réticent à dépasser environ cinq figures et quatre tableaux dans un article.
4. Le squelette pour le type de document à partir de references/structure.md, puis un plan de phrases thématiques : une ligne par paragraphe énonçant son point, dans l'ordre, avec le travail de chaque section nommé.
5. Marquez les positions de puissance : le premier et le dernier paragraphe de chaque section, la première et la dernière phrase de chaque paragraphe, le titre, les en-têtes (Alley, Heard). Mettez le résultat principal là où le texte borde l'espace blanc.
6. Listez ce qui reste en dehors (le test en trois parties de Heard : corps, supplément ou non publié) et les espaces réservés encore à remplir.

Formats de sortie

• Le texte de manuscrit est prêt à coller : texte brut, une ligne physique par paragraphe, pas de marqueurs Markdown, pas de puces, pas de numérotation, pas de blocs de code, pas de sauts de ligne durs et pas de tirets cadratins. L'auteur le colle dans Word. Lorsque le texte remplace une prose existante, nommez le point d'atterrissage : citez les premier et dernier mots à supprimer et dites si le remplacement est une phrase, un paragraphe ou une sous-section (style maison).
• La liste des modifications est courte et groupée : ce qui a changé, la règle et son auteur, pourquoi cela aide le lecteur. Les détails insignifiants (virgules, une faute de frappe) vont dans une ligne avec un décompte.
• La liste des coupes nomme chaque phrase supprimée et pourquoi elle est partie (répétition, métadiscours, une réserve qui n'a changé aucune affirmation, un détail qui ne pourrait pas changer l'interprétation du lecteur).
• Les résultats (Diagnostiquer) utilisent le format de chat normal, classés.
• Une entrée .docx : extrayez le texte, travaillez dessus et livrez une prose prête à coller. Les modifications suivies dans le fichier lui-même nécessitent une édition docx.

Scripts

scripts/prose_signals.py : un analyseur de signaux de prose qui lit un fichier texte (ou entrée standard) et produit des statistiques et des alertes. Exécutez-le avec python3 scripts/prose_signals.py <fichier> pour la sortie normale, ou --json pour la sortie JSON. Les sections sont séparées dans la sortie par ---. Signaux rapportés : longueurs de phrases ; candidats passifs (une heuristique simple basée sur les formes de « be ») ; phrases commençant par un explétif (there, it) ; nominalisations (mots se terminant par -tion, -ment, -ance, -ence, -ity, -ness) ; phrases de remplissage (une liste de termes de remplissage courants) ; atténuateurs et intensificateurs ; « Ceci » en début de phrase ; chaînes de noms ; tirets cadratins ; acronymes à usage unique. L'en-tête de sortie indique que ce sont des signaux, pas des verdicts. Utilisation : python3 scripts/prose_signals.py <fichier>. Pour la sortie JSON, ajoutez --json.

Fichiers de référence

references/house-style.md

Fichier de style maison qui contient les préférences permanentes de l'auteur. Chargé en premier à chaque invocation. Comprend un ensemble de démarrage que l'auteur peut modifier. Contient des décisions sur la voix, le ton, les pronoms, les formats et d'autres préférences qui s'appliquent à tous les documents de cet auteur. Les modifications apportées ici affectent toutes les sorties futures. Les valeurs par défaut sont documentées dans l'en-tête du fichier.

references/structure.md

Squelettes structurels pour différents types de documents : articles de revue, chapitres de livres, propositions de subvention, thèses, résumés, lettres de motivation, réponses aux relecteurs. Chaque squelette nomme les sections, leur ordre, leur objectif et ce que chaque section doit contenir sur la base des livres source. Inclut des conseils sur la façon d'ouvrir et de fermer chaque section, l'emplacement des résultats et la gestion des limites de longueur.

references/paragraphs.md

Règles pour l'écriture des paragraphes : un point par paragraphe, annoncé tôt ; nouvelles informations à la fin ; connecteurs entre les phrases ; longueur du paragraphe ; gestion des preuves. Toutes les règles sont attribuées à Alley, Heard ou Strunk. Inclut des exemples de bons et mauvais paragraphes.

references/sentences.md

Règles pour l'écriture des phrases : acteur à côté de l'action, verbe tôt, une idée par phrase, voix active préférée sauf exceptions définies (passif pour masquer l'acteur, pour déplacer l'accent, pour des raisons de longueur), pas de « ceci » nu, pas de modificateur mal attaché, pas de pronom ambigu. Toutes les règles sont attribuées à Strunk, Zinsser, Alley ou Heard.

references/words.md

Règles pour le choix des mots : éviter les phrases de remplissage, les nominalisations, les intensificateurs, les atténuations empilées, le jargon et les nombres inutilement précis. Comment signaler des nombres avec une précision appropriée. Comment définir les acronymes. Comment gérer les termes techniques. Toutes les règles sont attribuées aux auteurs source.

Exemple de flux de travail

1. L'utilisateur dit : « Cette introduction est dense. Pouvez-vous l'aider ? »
2. La compétence identifie le mode : Diagnostiquer ou Réviser (selon l'étendue de la demande).
3. Charge house-style.md et structure.md.
4. Exécute prose_signals.py sur le texte fourni.
5. Analyse le texte selon les principes des quatre livres.
6. Livre des résultats classés (si Diagnostiquer) ou un texte révisé (si Réviser) avec une liste de modifications.

À ne pas faire

• N'inventez pas de nombres, de citations, de résultats ou d'affirmations qui ne figurent pas dans la source.
• Ne changez pas le sens ou les affirmations du texte original, sauf si l'utilisateur le demande explicitement.
• Ne réécrivez pas l'intégralité d'un paragraphe uniquement pour le style, sauf si le mode le permet explicitement (Resserrer une ébauche).
• N'ignorez pas les préférences de l'auteur dans house-style.md.
• Ne livrez pas de texte avec des marqueurs Markdown ou des sauts de ligne durs lorsque du texte de manuscrit est demandé.
• Ne dépassez pas la limite de résultats pour les diagnostics (maximum 12 résultats, 800-1200 mots).