Discipline des citations

Spec: ISO/IEC/IEEE 26514 Spec: ISO 24495-1 Evidence: Editorial

En bref

C’est la page vers laquelle renvoie le reste d’Insider_ lorsqu’il parle de « niveau de preuve ». Elle explique pourquoi cette documentation paraphrase les standards au lieu de les citer, comment une affirmation est reliée à un identifiant de référence que tu peux revérifier, et ce que chacun des huit niveaux de preuve promet précisément ou ne promet pas.

Elle s’adresse à un ingénieur expérimenté qui, avant de faire confiance à une affirmation, veut connaître les règles selon lesquelles elle a été formulée — à juste titre.

Pourquoi c’est important

Chaque autre page d’Insider_ formule des affirmations et les accompagne d’un niveau de preuve. Cette indication n’a de valeur que si le système qui la sous-tend est explicite. Si « adossé à un standard » pouvait signifier tout et n’importe quoi, de « j’ai lu attentivement la spécification » à « je me souviens à peu près de ce qu’elle disait », le badge ne serait qu’une décoration.

Il existe aussi une contrainte plus stricte. Beaucoup des documents auxquels NextPDF se réfère — les spécifications ISO, ETSI et apparentées — sont sous licence. En reproduire le texte, quelle qu’en soit la longueur, n’est pas autorisé. La discipline doit donc résoudre deux problèmes à la fois : rendre une affirmation vérifiable au regard de sa source, sans reproduire cette source. Le même mécanisme répond aux deux, et cette page en est la spécification.

La version courte

Insider_ paraphrase les standards et ne cite jamais textuellement ceux qui sont sous licence. Une affirmation mentionne le standard, la clause et un identifiant de référence ; elle ne reproduit pas les mots du standard.
La paraphrase n’est pas un contournement ; c’est un test de compréhension. Reformuler une exigence dans la voix propre de NextPDF force le rédacteur à la comprendre, tout en maintenant la terminologie cohérente avec le glossaire Spec: ISO/IEC/IEEE 26514, §8 .
Chaque affirmation adossée à un standard porte un reference_id de 64 caractères dans la partie citations de l’en-tête de la page, afin que le prochain relecteur puisse retrouver l’extrait source exact et confirmer la paraphrase.
Le badge déclare un niveau de preuve — l’un des huit types — qui précise le genre de preuve, de sorte qu’une surévaluation se remarque au premier coup d’œil.
Lorsque la source ne peut pas être récupérée, l’affirmation n’est pas falsifiée. Elle est conservée, marquée comme non résolue dans un registre de ré-épinglage, et la page reste non publiée — un protocole documenté, pas une improvisation.

Comment NextPDF l’aborde

Paraphraser, pas citer

La règle la plus stricte de la hiérarchie de style de NextPDF prime sur tout guide en amont : aucun texte mot pour mot provenant d’un organisme de normalisation sous licence, quelle que soit la brièveté de l’extrait. À la place, une page mentionne le standard et la clause, paraphrase l’exigence avec sa propre voix, et consigne l’identifiant de référence de la source.

On présente généralement cela comme une contrainte de licence, et c’en est bien une. Mais la lecture la plus utile est éditoriale. Une citation mot pour mot prouve seulement que tu sais copier. Une paraphrase fidèle prouve que tu as assez bien compris la clause pour la reformuler sans en changer le sens. Elle permet aussi à la phrase de rester dans le vocabulaire cohérent de NextPDF, au lieu de changer de registre en milieu de page, ce qu’exige le modèle de qualité documentaire Spec: ISO/IEC/IEEE 26514, §8 . La langue claire se juge à la capacité d’un lecteur à trouver, comprendre et utiliser le contenu, non à la proximité de la prose avec la source Spec: ISO 24495-1, §Introduction  ; la paraphrase aide, la citation non.

Une affirmation est rattachée à un identifiant de référence, pas à un souvenir

Le mécanisme qui rend une paraphrase vérifiable est l’identifiant de référence. Chaque affirmation adossée à un standard porte un reference_id complet de 64 caractères dans la partie citations de l’en-tête de la page, qui identifie l’extrait source exact à partir duquel la paraphrase a été faite. Un relecteur n’a pas à se fier à la mémoire du rédacteur ; il récupère à nouveau cet extrait et le compare. L’identifiant de référence est le lien entre une source qu’on ne peut pas citer textuellement et une affirmation vérifiable. Il transporte l’emplacement de la preuve sans transporter le texte de la preuve.

Le niveau de preuve dit quel genre de preuve il s’agit

Une citation répond à « d’où ». Le niveau de preuve répond à « quel genre ». Chaque page d’Insider_ en déclare un, affiché dans la rangée de badges, tiré d’un ensemble fixe de huit types. L’ordre de confiance classe le code et les tests au-dessus de l’exécution, l’exécution au-dessus des métadonnées, et les métadonnées au-dessus de la prose ; une page éditoriale ne prétend pas être adossée au code.

Niveau de preuve	Ce qu’il promet	Ce qu’il ne promet pas
Evidence: Code-backed	L’affirmation est vérifiée par rapport au code source du moteur ou à un exemple exécutable	Qu’un standard l’impose
Evidence: Standard-backed	L’affirmation est ancrée dans une clause citée et paraphrasée, avec un identifiant de référence	Que le code l’implémente actuellement sans exception
Evidence: Test-backed	Un test de la suite maintient le comportement en place	Un chiffre de performance
Evidence: Benchmark-backed	Une mesure réalisée selon une méthode énoncée appuie le chiffre	Le même chiffre sur ton matériel
Evidence: Artifact-backed	Un artefact produit (une sortie de build, un rapport) le démontre	Une exigence imposée par un standard
Evidence: Design principle	Une décision de conception délibérée et argumentée	Une mesure empirique
Evidence: Editorial	Une explication raisonnée qui organise d’autres preuves	Une nouvelle garantie de comportement qui lui est propre
Evidence: Mixed evidence	La page mêle plusieurs bases et indique laquelle, affirmation par affirmation	Une base unique et homogène

Cette page est Evidence: Editorial  : elle n’affirme aucun comportement de moteur qui lui soit propre. Elle explique le système sur lequel reposent les badges des autres pages. C’est le niveau juste pour elle, et le dire, c’est appliquer la discipline à elle-même.

Quand la source ne peut pas être récupérée

La récupération n’est pas toujours disponible. L’intégrité de la discipline se révèle dans ce qui se passe alors. Une file d’attente normale, une limite de débit ou une pause de budget n’est pas une panne. Le rédacteur attend. Une véritable panne déclenche un repli documenté : l’affirmation est conservée, rattachée aux preuves présentes dans le dépôt et à la référence au standard que le code lui-même déclare, explicitement marquée comme non résolue dans un registre de ré-épinglage permanent, et la page reste non publiée jusqu’à ce que l’identifiant de référence soit réellement épinglé.

Les manœuvres interdites sont énumérées et vérifiables : un identifiant de référence fabriqué, une valeur complétée ou préfixée artificiellement pour paraître réelle, une clause écrite de mémoire et déguisée en citation récupérée, ou la suppression silencieuse de l’affirmation pour éviter la citation. Une panne correctement marquée dans un brouillon est une dette assortie d’une entrée de registre, pas un défaut. Un contrôle hors ligne et déterministe applique exactement cette distinction.

Ce que disent les preuves

Cette page est Evidence: Editorial , donc son propre fondement est la gouvernance documentaire de ce dépôt, ainsi que les standards qui justifient la discipline. Les affirmations ici sont vérifiables de deux manières : en lisant les règles présentes dans le dépôt, et en récupérant à nouveau les clauses citées.

Affirmation	Base	Ancrage
La paraphrase force la compréhension	Standard	La langue claire est jugée par l’usage du lecteur, pas par le calque de la source Spec: ISO 24495-1, §Introduction
La terminologie reste cohérente	Standard	Emploi cohérent de chaque terme d’un bout à l’autre Spec: ISO/IEC/IEEE 26514, §8
La relecture fait partie du processus	Standard	Tests de vérification et de validation intégrés au développement Spec: ISO/IEC/IEEE 26513, §Foreword
Le niveau de preuve est reconnaissable en premier	Standard	La reconnaissance plutôt que le rappel Spec: ISO 9241-110, §5.6.2
Aucun texte sous licence reproduit mot pour mot ; épinglage par référence	Dans le dépôt	`docs/style/nextpdf-overrides.md` §5 ; `composer docs:jaccard-fingerprint`
Le repli en cas de panne est un vrai protocole	Dans le dépôt	La gouvernance normative du repli RAG + le contrôle hors ligne `docs:rag-fallback-check`

Exemple concret

La discipline est concrète : elle se voit dans la structure de la partie citations de l’en-tête d’une page. Chaque entrée sert de justificatif à une affirmation.

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # full 64-char reference ID — the join to the source span, re-verifiable
    reference_id: "<64-hex digest>"
    # NextPDF-worded topic — the paraphrase, never the standard's text
    topic: "A writer's created or amended PDF elements must conform and stay consistent"

Il n’y a pas de champ quote, à dessein. Le topic est la reformulation propre de NextPDF. Le reference_id est la façon dont un relecteur revient à la source exacte pour vérifier cette reformulation. Le justificatif porte le pointeur vers la preuve, pas les mots de la preuve.

Idée fausse courante

L’erreur consiste à lire « paraphrase, ne cite pas » comme une échappatoire — un moyen de faire autorité sans s’engager. C’est l’inverse. Une citation n’engage à rien ; elle emprunte les mots de quelqu’un d’autre. Une paraphrase citée engage le rédacteur sur une reformulation qu’un relecteur peut réfuter au regard de la source. La discipline rend les affirmations plus redevables, pas moins.

La deuxième erreur consiste à traiter « éditorial » comme un grade inférieur d’« adossé à un standard ». Ce n’est pas du tout un grade ; c’est un genre différent. Une page éditoriale comme celle-ci organise et explique d’autres preuves. Elle est correctement étiquetée. Et l’étiquette est l’essentiel : le système fonctionne parce qu’une page t’indique quel genre de preuve elle offre avant que tu décides du poids à lui accorder.

Limites et frontières

Cette page spécifie la discipline de citation ; elle n’est ni le guide de style, ni la gouvernance du repli, ni le code du contrôle. Les artefacts faisant autorité sont présents dans le dépôt (docs/style/nextpdf-overrides.md §5, la gouvernance normative du repli RAG, les scripts composer.jsondocs:*) et l’emportent sur tout résumé présenté ici en cas de divergence. Elle n’affirme aucun comportement de moteur.

La discipline lie l’affirmation, pas la conclusion du lecteur. Une paraphrase fidèlement citée t’indique ce qu’une clause exige. Déterminer si l’interprétation de NextPDF correspond à ton obligation reste ta décision, et c’est pourquoi les pages comportementales portent aussi des preuves adossées au code ou aux tests, pas seulement adossées à un standard. L’application reste partielle, et c’est assumé honnêtement : le contrôle de repli hors ligne est actif, et les vérificateurs de citation mot pour mot et de citation en temps réel sont câblés, leurs exécuteurs exhaustifs étant encore en cours d’achèvement — ils sont donc présentés comme en cours, pas comme terminés.

Documentation connexe

La documentation comme produit — la discipline de qualité plus large dans laquelle s’inscrit ce système de citation.
Le paysage des standards — les standards que ces citations désignent, et comment une clause devient un comportement documenté.
La pyramide de tests de NextPDF — ce que signifie une preuve adossée aux tests quand une page revendique ce niveau plutôt que le niveau éditorial.

Glossaire

Discipline de citation — l’ensemble des règles régissant la façon dont une affirmation d’Insider_ est rattachée à sa source : paraphraser, citer la clause, épingler un identifiant de référence, ne jamais citer textuellement un standard sous licence.
Paraphrase — une reformulation d’une exigence dans la voix propre de NextPDF, cohérente avec le glossaire ; le test de compréhension qui remplace la citation.
reference_id — le pointeur d’intégrité complet de 64 caractères vers l’extrait source exact à partir duquel une paraphrase a été faite, consigné pour qu’un relecteur puisse le retrouver et vérifier la paraphrase.
Niveau de preuve — le genre déclaré de preuve à l’appui des affirmations d’une page, l’un des huit (adossé au code, à un standard, aux tests, à un benchmark, à un artefact, principe de conception, éditorial, mixte), affiché dans la rangée de badges.
Citation non résolue — une affirmation dont l’identifiant de référence n’a pas pu être épinglé en raison d’une véritable panne de récupération ; conservée, marquée dans un registre de ré-épinglage, et retenue avant publication plutôt que falsifiée.