Zitierdisziplin

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

Auf einen Blick

Dies ist die Seite, auf die der Rest von Insider_ verweist, wenn er erläutert, wie er einen Standard zitiert. Sie erläutert, warum diese Dokumentation Spezifikationen paraphrasiert, statt sie zu zitieren, wie eine Aussage den Standard und die genaue Klausel nennt, auf der sie beruht, und was ein sauberes Zitat 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 bindet sie an einen benannten Standard und eine Klausel. Dieses Zitat ist nur dann aussagekräftig, wenn die Disziplin 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 Zitat 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 auf ihre Quelle rückverfolgbar machen, ohne diese Quelle zu reproduzieren. Ein präzises Zitat und eine getreue Paraphrase lösen beides, und diese Seite ist ihre Spezifikation.

Die Kurzfassung

Insider_ paraphrasiert Standards und zitiert lizenzierte Standards niemals wörtlich. Eine Aussage nennt den Standard und die genaue Klausel; 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 nennt eine bestimmte Klausel oder einen bestimmten Abschnitt, nicht ein ganzes Dokument, damit die nächste prüfende Person diese Klausel öffnen und die Paraphrase daran bestätigen kann.
Ein Zitat gibt an, auf welcher Art von Quelle es beruht – einer Klausel, dem Quellcode der Engine, einem Test, einer Messung –, damit eine Überzeichnung auf einen Blick sichtbar ist.
Wenn eine Aussage nicht an eine Klausel gebunden werden kann, die die schreibende Person tatsächlich gelesen hat, wird sie nicht gefälscht. Sie bleibt erhalten, wird 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 hat Vorrang vor jedem 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 und paraphrasiert die Anforderung in ihrer eigenen Stimme.

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 nennt die Klausel, nicht nur das Dokument

Der Mechanismus, der eine Paraphrase überprüfbar macht, ist Präzision. Jede standardgestützte Aussage nennt die genaue Klausel oder den genauen Abschnitt, auf der bzw. dem sie beruht – etwa ISO 32000-2 §6 – nicht nur das Dokument. Eine prüfende Person muss dem Gedächtnis der schreibenden Person nicht vertrauen; sie öffnet diese Klausel und vergleicht sie mit der Neuformulierung. Der Klauselverweis ist die Verbindung zwischen einer nicht zitierbaren Quelle und einer überprüfbaren Aussage. Er hält fest, wo nachzuschlagen ist, ohne den Text der Quelle mitzuführen.

Ein Zitat sagt, welche Art von Quelle dies ist

Ein Zitat beantwortet „woher“. Es muss auch „welche Art“ beantworten. Zu sagen, eine Aussage werde durch eine Klausel eines Standards gestützt, ist ein anderes Versprechen, als zu sagen, sie werde durch den eigenen Code der Engine, durch einen Test oder durch eine Messung gestützt. NextPDF hält diese Arten getrennt, damit eine lesende Person sie abwägen kann: Code und Tests rangieren über Laufzeitverhalten, Laufzeitverhalten über Metadaten und Metadaten über Prosa. Eine redaktionelle Seite wie diese gibt nicht vor, codegestützt zu sein.

Art der Quelle	Was sie verspricht	Was sie nicht verspricht
Codegestützt	Die Aussage wird gegen den Quellcode der Engine oder ein lauffähiges Beispiel geprüft	Dass sie von einem Standard vorgeschrieben wird
Standardgestützt	Die Aussage ist an eine referenzierte, paraphrasierte Klausel verankert	Dass der Code sie derzeit ausnahmslos umsetzt
Testgestützt	Ein Test in der Suite hält das Verhalten fest	Eine Leistungszahl
Benchmark-gestützt	Die Zahl wird durch eine Messung nach angegebener Methode gestützt	Dieselbe Zahl auf Ihrer Hardware
Artefaktgestützt	Ein erzeugtes Artefakt (eine Build-Ausgabe, ein Bericht) belegt sie	Eine Standardvorgabe
Designprinzip	Eine bewusste, begründete Designentscheidung	Eine empirische Messung
Redaktionell	Eine begründete Erklärung, die anderes Material ordnet	Eine neue eigene Verhaltensgarantie
Gemischt	Die Seite kombiniert Grundlagen und gibt je Aussage an, welche	Eine einzige klare Grundlage

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

Wenn die Quelle nicht gelesen werden kann

Der Zugang zu einem Standard ist nicht immer sofort gegeben – eine lizenzierte Spezifikation kann eine sein, die eine schreibende Person erst noch beschaffen muss, oder eine Klausel braucht eine zweite Lektüre, bis ihre Bedeutung klar ist. Die Integrität der Disziplin zeigt sich daran, was dann geschieht. Die schreibende Person rät nicht. Eine Aussage, die noch nicht an eine Klausel gebunden werden kann, die die schreibende Person tatsächlich gelesen hat, wird beibehalten, mit Material im Repository und den Standardreferenzen verknüpft, die der Code selbst deklariert, ausdrücklich als ungelöst markiert, und die Seite bleibt unveröffentlicht, bis die Klausel ordnungsgemäß zitiert ist.

Die verbotenen Schritte sind aufgezählt und überprüfbar: eine Klauselnummer, die erfunden wurde, um präzise zu wirken, ein Zitat, das so aufgemacht ist, als wäre es gelesen worden, obwohl es aus dem Gedächtnis geschrieben wurde, oder das stillschweigende Löschen der Aussage, um die Zitation zu umgehen. Ein korrekt markiertes offenes Zitat in einem Entwurf ist offene Schuld mit einem Vermerk, kein Defekt. Eine offline laufende, deterministische Prüfung erzwingt genau diese Unterscheidung.

Praktisches Beispiel

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

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"

Es gibt kein quote-Feld, und das ist beabsichtigt. Das topic ist NextPDFs eigene Neuformulierung. spec und clause sind 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 die Klausel, nicht deren 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 Klausel 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 anderes Material. Sie ist korrekt beschriftet. Genau dieses Etikett ist entscheidend: Das System funktioniert, weil eine Seite Ihnen sagt, auf welcher Art von Quelle sie beruht, bevor Sie entscheiden, wie viel Gewicht Sie ihr geben.

Grenzen und Abgrenzungen

Diese Seite spezifiziert die Zitierdisziplin; sie ist nicht das Stylesheet oder der Gate-Code. Die maßgeblichen Artefakte liegen im Repository (docs/style/nextpdf-overrides.md §5 und 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 Zitate tragen und nicht allein standardgestützte. Die Durchsetzung ist ehrlich als teilweise ausgewiesen: Die offline laufende 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 genaue Klausel nennen, einen lizenzierten Standard niemals zitieren.
Paraphrase – eine Neuformulierung einer Anforderung in NextPDFs eigener, glossarkonsistenter Stimme; der Verständnistest, der das Zitat ersetzt.
Klauselverweis – die genaue Klausel oder der genaue Abschnitt, auf der bzw. dem eine Paraphrase beruht, festgehalten, damit eine prüfende Person ihn öffnen und die Neuformulierung verifizieren kann.
Standardgestützte Aussage – eine Aussage, die an eine referenzierte, paraphrasierte Klausel eines benannten Standards verankert ist, im Unterschied zu einer, die durch den Code der Engine, einen Test, eine Messung oder redaktionelle Begründung gestützt wird.
Ungelöste Zitation – eine Aussage, die noch nicht an eine Klausel gebunden werden kann, die die schreibende Person gelesen hat; beibehalten, als offen markiert und von der Veröffentlichung zurückgehalten, statt gefälscht.