Zitierdisziplin

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

Auf einen Blick

Dies ist die Seite, auf die der Rest von Insider_ verweist, wenn von der „Evidenzstufe“ die Rede ist. Sie erläutert, warum diese Dokumentation Standards paraphrasiert, statt sie zu zitieren, wie eine Aussage an eine Referenz-ID gebunden ist, die Sie erneut überprüfen können, und was jede der acht Evidenzstufen genau verspricht – und was nicht.

Sie richtet sich an erfahrene Entwicklerinnen und Entwickler, die wissen wollen, nach welchen Regeln eine Aussage getroffen wurde, bevor sie ihr vertrauen – und die diese Frage zu Recht stellen.

Warum das wichtig ist

Jede andere Insider_-Seite trifft Aussagen und versieht sie mit einer Evidenzstufe. Dieser Stempel ist nur dann aussagekräftig, wenn das System dahinter explizit ist. Wenn „standardgestützt“ alles bedeuten könnte, von „Ich habe die Spezifikation sorgfältig gelesen“ bis „Ich erinnere mich ungefähr an ihren Inhalt“, ist das Badge nur Dekoration.

Hinzu kommt eine härtere Einschränkung. Viele der Dokumente, an denen sich NextPDF orientiert – ISO-, ETSI- und ähnliche Spezifikationen –, sind lizenziert. Ihren Wortlaut wiederzugeben, sei der Auszug noch so kurz, ist nicht gestattet. Die Disziplin muss also zwei Probleme zugleich lösen: eine Aussage gegenüber ihrer Quelle überprüfbar machen, ohne diese Quelle zu reproduzieren. Beides löst derselbe Mechanismus, und diese Seite ist seine Spezifikation.

Die Kurzfassung

Insider_ paraphrasiert Standards und zitiert lizenzierte Standards niemals wörtlich. Eine Aussage nennt den Standard, die Klausel und eine Referenz-ID; sie gibt nicht den Wortlaut des Standards wieder.
Paraphrasieren ist kein Umgehen; es ist ein Verständnistest. Eine Anforderung in NextPDFs eigener Stimme neu zu formulieren, zwingt die schreibende Person, sie zu verstehen, und hält die Terminologie konsistent mit dem Glossar Spec: ISO/IEC/IEEE 26514, §8 .
Jede standardgestützte Aussage trägt eine 64 Zeichen lange reference_id im citations-Frontmatter der Seite, damit die nächste prüfende Person den exakten Quellabschnitt erneut abrufen und die Paraphrase bestätigen kann.
Das Badge deklariert eine Evidenzstufe – eine von acht Arten –, die die Art des Belegs angibt, damit eine Überzeichnung auf einen Blick sichtbar ist.
Wenn die Quelle nicht abgerufen werden kann, wird die Aussage nicht gefälscht. Sie bleibt erhalten, wird gegen ein Re-Pinning-Ledger als ungelöst markiert, und die Seite bleibt unveröffentlicht – ein dokumentiertes Protokoll, keine Improvisation.

Wie NextPDF damit umgeht

Paraphrase, kein Zitat

Die strengste Regel in der NextPDF-Stilhierarchie überschreibt jeden vorgelagerten Leitfaden: kein wörtlicher Text einer lizenzierten Normungsorganisation, unabhängig davon, wie kurz der Auszug ist. Eine Seite nennt stattdessen den Standard und die Klausel, paraphrasiert die Anforderung in ihrer eigenen Stimme und erfasst die Referenz-ID der Quelle.

Das wird meist als Lizenzbeschränkung dargestellt, und das ist es auch. Nützlicher ist jedoch die redaktionelle Sicht. Ein wörtliches Zitat beweist nur, dass Text kopiert wurde. Eine getreue Paraphrase beweist, dass Sie die Klausel gut genug verstanden haben, um sie ohne Bedeutungsänderung neu zu formulieren. Außerdem hält sie den Satz in NextPDFs einheitlichem Vokabular, statt mitten auf der Seite das Register zu wechseln, wie es das Dokumentationsqualitätsmodell verlangt Spec: ISO/IEC/IEEE 26514, §8 . Klare Sprache wird daran gemessen, ob eine lesende Person den Inhalt finden, verstehen und nutzen kann, nicht daran, ob die Prosa die Quelle Spec: ISO 24495-1, §Introduction spiegelt; diesem Ziel dient die Paraphrase, das Zitat nicht.

Eine Aussage ist an eine Referenz-ID gebunden, nicht an ein Gedächtnis

Der Mechanismus, der eine Paraphrase überprüfbar macht, ist die Referenz-ID. Jede standardgestützte Aussage trägt im citations-Frontmatter der Seite eine vollständige, 64 Zeichen lange reference_id, die den exakten Quellabschnitt identifiziert, aus dem die Paraphrase erstellt wurde. Eine prüfende Person muss dem Gedächtnis der schreibenden Person nicht vertrauen; sie ruft diesen Abschnitt erneut ab und vergleicht. Die Referenz-ID ist die Verbindung zwischen einer nicht zitierbaren Quelle und einer überprüfbaren Aussage. Sie hält fest, wo der Beleg liegt, ohne den Text des Belegs mitzuführen.

Die Evidenzstufe sagt, welche Art von Beleg dies ist

Eine Zitation beantwortet „woher“. Die Evidenzstufe beantwortet „welche Art“. Jede Insider_-Seite deklariert eine, angezeigt in der Badge-Reihe, ausgewählt aus einer festen Menge von acht. Die Vertrauensrangfolge setzt Code und Tests über Laufzeitbelege, Laufzeitbelege über Metadaten und Metadaten über Prosa; eine redaktionelle Seite gibt nicht vor, codegestützt zu sein.

Evidenzstufe	Was sie verspricht	Was sie nicht verspricht
Evidence: Code-backed	Die Aussage wird gegen den Quellcode der Engine oder ein lauffähiges Beispiel geprüft	Dass sie von einem Standard vorgeschrieben wird
Evidence: Standard-backed	Die Aussage ist an eine referenzierte, paraphrasierte Klausel mit einer Referenz-ID verankert	Dass der Code sie derzeit ausnahmslos umsetzt
Evidence: Test-backed	Ein Test in der Suite hält das Verhalten fest	Eine Leistungszahl
Evidence: Benchmark-backed	Die Zahl wird durch eine Messung nach angegebener Methode gestützt	Dieselbe Zahl auf Ihrer Hardware
Evidence: Artifact-backed	Ein erzeugtes Artefakt (eine Build-Ausgabe, ein Bericht) belegt sie	Eine Standardvorgabe
Evidence: Design principle	Eine bewusste, begründete Designentscheidung	Eine empirische Messung
Evidence: Editorial	Eine begründete Erklärung, die andere Belege ordnet	Eine neue eigene Verhaltensgarantie
Evidence: Mixed evidence	Die Seite kombiniert Grundlagen und gibt je Aussage an, welche	Eine einzige klare Grundlage

Diese Seite ist Evidence: Editorial : Sie behauptet kein eigenes Engine-Verhalten. Sie erläutert das System, auf das sich die Badges der anderen Seiten stützen. Das ist die ehrliche Stufe dafür, und das ausdrücklich zu sagen, ist die auf sich selbst angewandte Disziplin.

Wenn die Quelle nicht abgerufen werden kann

Der Abruf ist nicht immer verfügbar. Die Integrität der Disziplin zeigt sich daran, was dann geschieht. Eine normale Warteschlange, ein Ratenlimit oder eine Budgetpause ist kein Ausfall. Die schreibende Person wartet. Ein echter Ausfall löst einen dokumentierten Fallback aus: Die Aussage wird beibehalten, mit Belegen im Repository und den Standardreferenzen verknüpft, die der Code selbst deklariert, gegen ein bestehendes Re-Pinning-Ledger ausdrücklich als ungelöst markiert, und die Seite bleibt unveröffentlicht, bis die Referenz-ID wirklich verankert ist.

Die verbotenen Schritte sind aufgezählt und überprüfbar: eine erfundene Referenz-ID, ein Wert, der aufgefüllt oder mit einem Präfix versehen wurde, um echt zu wirken, eine aus dem Gedächtnis geschriebene Klausel, die als abgerufene Zitation getarnt ist, oder das stillschweigende Löschen der Aussage, um die Zitation zu umgehen. Ein korrekt markierter Ausfall in einem Entwurf ist offene Schuld mit einem Ledger-Eintrag, kein Defekt. Eine offline laufende, deterministische Prüfung erzwingt genau diese Unterscheidung.

Was die Belege aussagen

Diese Seite ist Evidence: Editorial , sodass ihre eigene Grundlage in der Dokumentations-Governance dieses Repositorys sowie in den Standards liegt, die die Disziplin rechtfertigen. Die Aussagen auf dieser Seite sind auf zwei Wegen überprüfbar: durch Lesen der Regeln im Repository und durch erneutes Abrufen der zitierten Klauseln.

Aussage	Grundlage	Anker
Paraphrase erzwingt Verständnis	Standard	Klare Sprache wird am Lesernutzen gemessen, nicht am Spiegeln der Quelle Spec: ISO 24495-1, §Introduction
Terminologie bleibt konsistent	Standard	Jeder Begriff wird durchgängig konsistent verwendet Spec: ISO/IEC/IEEE 26514, §8
Review ist Teil des Prozesses	Standard	Verifizierungs- und Validierungstests innerhalb der Entwicklung Spec: ISO/IEC/IEEE 26513, §Foreword
Evidenzstufe ist zuerst erkennbar	Standard	Wiedererkennen statt Erinnern Spec: ISO 9241-110, §5.6.2
Kein wörtlicher lizenzierter Text; referenzverankert	Im Repository	`docs/style/nextpdf-overrides.md` §5; `composer docs:jaccard-fingerprint`
Der Ausfall-Fallback ist ein echtes Protokoll	Im Repository	Die normative RAG-Fallback-Governance + das offline laufende `docs:rag-fallback-check`-Gate

Praktisches Beispiel

Die Disziplin ist konkret: Sie steckt in der Struktur des citations-Frontmatters einer Seite. Jeder Eintrag belegt eine Aussage.

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"

Es gibt kein quote-Feld, und das ist beabsichtigt. Das topic ist NextPDFs eigene Neuformulierung. Die reference_id ist der Weg, über den eine prüfende Person zur exakten Quelle gelangt, um diese Neuformulierung zu überprüfen. Der Eintrag trägt den Verweis auf den Nachweis, nicht dessen Wortlaut.

Häufiges Missverständnis

Die Falle besteht darin, „paraphrasieren, nicht zitieren“ als Absicherung zu lesen – als Weg, autoritativ zu klingen, ohne sich festzulegen. Das Gegenteil ist der Fall. Ein Zitat verpflichtet die schreibende Person zu nichts Eigenem; es leiht sich die Worte einer anderen Person. Eine referenzierte Paraphrase verpflichtet die schreibende Person auf eine Neuformulierung, die eine prüfende Person gegen die Quelle widerlegen kann. Die Disziplin macht Aussagen stärker rechenschaftspflichtig, nicht schwächer.

Die zweite Falle besteht darin, „redaktionell“ als schwächere Stufe von „standardgestützt“ zu behandeln. Es ist keine Stufe auf derselben Skala; es ist eine andere Art. Eine redaktionelle Seite wie diese ordnet und erläutert andere Belege. Sie ist korrekt beschriftet. Genau dieses Etikett ist entscheidend: Das System funktioniert, weil eine Seite Ihnen sagt, welche Art von Beleg sie bietet, bevor Sie entscheiden, wie viel Gewicht Sie ihr geben.

Grenzen und Abgrenzungen

Diese Seite spezifiziert die Zitierdisziplin; sie ist nicht das Stylesheet, die Fallback-Governance oder der Gate-Code. Die maßgeblichen Artefakte liegen im Repository (docs/style/nextpdf-overrides.md §5, die normative RAG-Fallback-Governance, die composer.jsondocs:*-Skripte) und haben bei Abweichungen Vorrang vor jeder Zusammenfassung hier. Diese Seite behauptet kein Engine-Verhalten.

Die Disziplin bindet die Aussage, nicht die Schlussfolgerung der lesenden Person. Eine getreu referenzierte Paraphrase sagt Ihnen, was eine Klausel verlangt. Ob NextPDFs Lesart diejenige ist, die Ihre Pflicht erfordert, bleibt Ihre Entscheidung, weshalb verhaltensbezogene Seiten zusätzlich code- oder testgestützte Belege tragen und nicht allein standardgestützte. Die Durchsetzung ist ehrlich als teilweise ausgewiesen: Die offline laufende Fallback-Prüfung ist aktiv, und die Verifizierer für wörtliche Zitate und Live-Zitationen sind angebunden, während ihre vollständigen Runner noch fertiggestellt werden – als in Arbeit ausgewiesen, nicht als erledigt.

Glossar

Zitierdisziplin – das Regelwerk, das festlegt, wie eine Insider_-Aussage an ihre Quelle gebunden wird: paraphrasieren, die Klausel referenzieren, eine Referenz-ID verankern, einen lizenzierten Standard niemals zitieren.
Paraphrase – eine Neuformulierung einer Anforderung in NextPDFs eigener, glossarkonsistenter Stimme; der Verständnistest, der das Zitat ersetzt.
reference_id – der vollständige, 64 Zeichen lange Integritätsverweis auf den exakten Quellabschnitt, aus dem eine Paraphrase erstellt wurde, festgehalten, damit eine prüfende Person ihn erneut abrufen und verifizieren kann.
Evidenzstufe – die deklarierte Art des Belegs hinter den Aussagen einer Seite, eine von acht (code-, standard-, test-, benchmark-, artefaktgestützt, Designprinzip, redaktionell, gemischt), angezeigt in der Badge-Reihe.
Ungelöste Zitation – eine Aussage, deren Referenz-ID aufgrund eines echten Abrufausfalls nicht verankert werden konnte; beibehalten, gegen ein Re-Pinning-Ledger markiert und von der Veröffentlichung zurückgehalten, statt gefälscht.