Discipline des citations

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

En bref

C’est la page vers laquelle renvoie le reste d’Insider_ lorsqu’il explique comment il cite un standard. Elle explique pourquoi cette documentation paraphrase les spécifications au lieu de les citer, comment une affirmation nomme le standard et la clause exacte sur laquelle elle s’appuie, et ce qu’une citation propre 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 rattache à un standard et à une clause nommés. Cette citation n’a de valeur que si la discipline 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 », la citation 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 traçable jusqu’à sa source, sans reproduire cette source. Une citation précise et une paraphrase fidèle répondent 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 nomme le standard et la clause exacte ; 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 nomme une clause ou une section précise, et non un document entier, afin que le prochain relecteur puisse ouvrir cette clause et y confirmer la paraphrase.
Une citation indique le genre de source sur laquelle elle s’appuie — une clause, le code du moteur, un test, une mesure — de sorte qu’une surévaluation se remarque au premier coup d’œil.
Lorsqu’une affirmation ne peut pas être rattachée à une clause que le rédacteur a réellement lue, elle n’est pas falsifiée. Elle est conservée, marquée comme non résolue, 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 nomme le standard et la clause et paraphrase l’exigence avec sa propre voix.

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 nomme la clause, pas seulement le document

Le mécanisme qui rend une paraphrase vérifiable est la précision. Chaque affirmation adossée à un standard nomme la clause ou la section exacte sur laquelle elle s’appuie — par exemple ISO 32000-2 §6 — et non le seul document. Un relecteur n’a pas à se fier à la mémoire du rédacteur ; il ouvre cette clause et la compare à la reformulation. La référence à la clause est le lien entre une source qu’on ne peut pas citer textuellement et une affirmation vérifiable. Elle indique où regarder sans transporter le texte de la source.

Une citation dit quel genre de source il s’agit

Une citation répond à « d’où ». Elle doit aussi répondre à « quel genre ». Dire qu’une affirmation s’appuie sur une clause d’un standard est une promesse différente de dire qu’elle s’appuie sur le code propre du moteur, sur un test ou sur une mesure. NextPDF garde ces genres distincts pour qu’un lecteur puisse les soupeser : le code et les tests passent avant le comportement à l’exécution, l’exécution avant les métadonnées, et les métadonnées avant la prose. Une page éditoriale comme celle-ci ne prétend pas être adossée au code.

Genre de source	Ce qu’elle promet	Ce qu’elle ne promet pas
Adossé au code	L’affirmation est vérifiée par rapport au code source du moteur ou à un exemple exécutable	Qu’un standard l’impose
Adossé à un standard	L’affirmation est ancrée dans une clause citée et paraphrasée	Que le code l’implémente actuellement sans exception
Adossé aux tests	Un test de la suite maintient le comportement en place	Un chiffre de performance
Adossé à un benchmark	Une mesure réalisée selon une méthode énoncée appuie le chiffre	Le même chiffre sur ton matériel
Adossé à un artefact	Un artefact produit (une sortie de build, un rapport) le démontre	Une exigence imposée par un standard
Principe de conception	Une décision de conception délibérée et argumentée	Une mesure empirique
Éditorial	Une explication raisonnée qui organise d’autres éléments	Une nouvelle garantie de comportement qui lui est propre
Mixte	La page mêle plusieurs bases et indique laquelle, affirmation par affirmation	Une base unique et homogène

Cette page est éditoriale : elle n’affirme aucun comportement de moteur qui lui soit propre. Elle explique la discipline sur laquelle reposent les citations des autres pages. C’est la base honnête pour elle, et le dire, c’est appliquer la discipline à elle-même.

Quand la source ne peut pas être lue

L’accès à un standard n’est pas toujours immédiat — une spécification sous licence peut être une que le rédacteur doit encore se procurer, ou une clause peut demander une seconde lecture pour que son sens devienne clair. L’intégrité de la discipline se révèle dans ce qui se passe alors. Le rédacteur ne devine pas. Une affirmation qui ne peut pas encore être rattachée à une clause que le rédacteur a réellement lue est conservée, rattachée aux éléments présents 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, et la page reste non publiée jusqu’à ce que la clause soit correctement citée.

Les manœuvres interdites sont énumérées et vérifiables : un numéro de clause inventé pour paraître précis, une citation maquillée comme si elle avait été lue alors qu’elle a été écrite de mémoire, ou la suppression silencieuse de l’affirmation pour éviter la citation. Une citation ouverte correctement marquée dans un brouillon est une dette assortie d’une note, pas un défaut. Un contrôle hors ligne et déterministe applique exactement cette distinction.

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 rattache une affirmation à sa clause.

citations:
  - spec: "ISO 32000-2"
    clause: "§6"
    # 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 spec et la clause sont la façon dont un relecteur revient à la source exacte pour vérifier cette reformulation. L’entrée porte le pointeur vers la clause, pas les mots de la clause.

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 clause. 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 éléments. Elle est correctement étiquetée. Et l’étiquette est l’essentiel : le système fonctionne parce qu’une page t’indique sur quel genre de source elle s’appuie 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 le code du contrôle. Les artefacts faisant autorité sont présents dans le dépôt (docs/style/nextpdf-overrides.md §5 et 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 citations 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 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 s’appuie sur cette base plutôt que sur celle-ci.

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, nommer la clause exacte, 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.
Référence à la clause — la clause ou la section exacte sur laquelle s’appuie une paraphrase, consignée pour qu’un relecteur puisse l’ouvrir et vérifier la reformulation.
Affirmation adossée à un standard — une affirmation ancrée dans une clause citée et paraphrasée d’un standard nommé, par opposition à une affirmation adossée au code du moteur, à un test, à une mesure ou à un raisonnement éditorial.
Citation non résolue — une affirmation qui ne peut pas encore être rattachée à une clause que le rédacteur a lue ; conservée, marquée comme ouverte, et retenue avant publication plutôt que falsifiée.