Citatiediscipline

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

In het kort

Dit is de pagina waarnaar de rest van Insider_ verwijst wanneer die uitlegt hoe ze een standaard citeert. Ze legt uit waarom deze documentatie specificaties parafraseert in plaats van citeert, hoe een bewering de standaard en de exacte clausule benoemt waarop ze steunt, en wat een nette citatie wel en niet belooft.

Ze is geschreven voor een senior engineer die de regels wil kennen waarmee beweringen zijn opgesteld voordat die erop vertrouwt — en daar terecht om vraagt.

Waarom dit belangrijk is

Elke andere Insider_-pagina formuleert beweringen en koppelt die aan een benoemde standaard en clausule. Die citatie is alleen iets waard als de discipline erachter expliciet is. Als “standard-backed” alles kan betekenen, van “ik heb de specificatie zorgvuldig gelezen” tot “ik herinner me ongeveer wat erin stond”, dan is de citatie niet meer dan decoratie.

Er is ook een strengere beperking. Veel van de documenten waaraan NextPDF zich verantwoordt — de ISO-, ETSI- en vergelijkbare specificaties — zijn gelicentieerd. Hun tekst reproduceren, ongeacht de lengte, is niet toegestaan. De discipline moet daarom twee problemen tegelijk oplossen: een bewering herleidbaar maken tot haar bron, zonder die bron te reproduceren. Een precieze citatie en een getrouwe parafrase beantwoorden beide, en deze pagina specificeert dat.

De korte versie

Insider_ parafraseert standaarden en citeert nooit gelicentieerde standaarden. Een bewering benoemt de standaard en de exacte clausule; ze reproduceert niet de bewoording van de standaard.
Parafraseren is geen omweg; het is een begripstoets. Een vereiste herformuleren in de eigen stem van NextPDF dwingt de schrijver die te begrijpen, en houdt de terminologie consistent met de woordenlijst Spec: ISO/IEC/IEEE 26514, §8.
Elke standard-backed bewering benoemt een specifieke clausule of sectie, geen heel document, zodat de volgende reviewer die clausule kan openen en de parafrase eraan kan toetsen.
Een citatie vermeldt het soort bron waarop ze steunt — een clausule, de code van de engine, een test, een meting — zodat een te sterke bewering in één oogopslag zichtbaar is.
Wanneer een bewering niet kan worden gekoppeld aan een clausule die de schrijver werkelijk heeft gelezen, wordt ze niet vervalst. Ze wordt behouden, als onopgelost gemarkeerd, en de pagina blijft ongepubliceerd — een gedocumenteerd protocol, geen improvisatie.

Hoe NextPDF dit aanpakt

Parafraseren, niet citeren

De strengste regel in de stijlhiërarchie van NextPDF gaat boven elke bovenliggende richtlijn: geen letterlijke tekst van een gelicentieerd normalisatie-instituut, hoe kort het fragment ook is. In plaats daarvan benoemt een pagina de standaard en clausule en parafraseert ze de vereiste in haar eigen stem.

Dit wordt meestal voorgesteld als een licentiebeperking, en dat is het ook. Toch is het nuttigere perspectief redactioneel. Een letterlijk citaat bewijst alleen dat iemand kan kopiëren. Een getrouwe parafrase toont aan dat de schrijver de clausule goed genoeg heeft begrepen om die te herformuleren zonder de betekenis te veranderen. Daardoor blijft de zin ook in de consistente woordenschat van NextPDF, in plaats van halverwege de pagina van register te wisselen, wat het documentatiekwaliteitsmodel vereist Spec: ISO/IEC/IEEE 26514, §8. Heldere taal wordt beoordeeld op de vraag of een lezer de inhoud kan vinden, begrijpen en gebruiken, niet op de vraag of het proza de bron weerspiegelt Spec: ISO 24495-1, §Introduction; parafraseren dient dat doel, citeren niet.

Een bewering benoemt de clausule, niet alleen het document

Het mechanisme dat een parafrase controleerbaar maakt, is precisie. Elke standard-backed bewering benoemt de exacte clausule of sectie waarop ze steunt — bijvoorbeeld ISO 32000-2 §6 — niet alleen het document. Een reviewer hoeft niet op het geheugen van de schrijver te vertrouwen; de reviewer opent die clausule en vergelijkt die met de herformulering. De clausuleverwijzing is de verbinding tussen een niet-citeerbare bron en een verifieerbare bewering. Ze geeft aan waar je moet kijken zonder de tekst van de bron mee te dragen.

Een citatie zegt wat voor soort bron dit is

Een citatie beantwoordt “waarvandaan”. Ze moet ook “welk soort” beantwoorden. Zeggen dat een bewering steunt op een clausule van een standaard is een andere belofte dan zeggen dat ze steunt op de eigen code van de engine, op een test of op een meting. NextPDF houdt die soorten gescheiden zodat een lezer ze kan afwegen: code en tests gaan boven runtimegedrag, runtime boven metadata, en metadata boven proza. Een redactionele pagina zoals deze doet niet alsof ze code-backed is.

Soort bron	Wat het belooft	Wat het niet belooft
Code-backed	De bewering wordt getoetst aan de broncode van de engine of aan een uitvoerbaar voorbeeld	Dat een standaard het verplicht stelt
Standard-backed	De bewering is verankerd aan een geciteerde, geparafraseerde clausule	Dat de code het momenteel zonder uitzondering implementeert
Test-backed	Een test in de suite houdt het gedrag op zijn plaats	Een prestatiecijfer
Benchmark-backed	Een meting volgens een vastgelegde methode ondersteunt het cijfer	Hetzelfde cijfer op je hardware
Artifact-backed	Een geproduceerd artefact (een build-uitvoer, een rapport) toont het aan	Een standaardvereiste
Ontwerpprincipe	Een weloverwogen, beargumenteerde ontwerpbeslissing	Een empirische meting
Redactioneel	Een beredeneerde uitleg die ander materiaal ordent	Een nieuwe gedragsgarantie op zichzelf
Gemengd	De pagina combineert grondslagen en geeft per bewering aan welke	Eén heldere grondslag

Deze pagina is redactioneel: ze beweert geen eigen enginegedrag. Ze legt de discipline uit waarop de citaties van de andere pagina’s steunen. Dat is de eerlijke grondslag ervoor, en dat benoemen is de discipline toegepast op zichzelf.

Wanneer de bron niet kan worden gelezen

Toegang tot een standaard is niet altijd onmiddellijk — een gelicentieerde specificatie kan er een zijn die de schrijver nog moet aanschaffen, of een clausule kan een tweede lezing vergen voordat de betekenis duidelijk is. De integriteit van de discipline blijkt uit wat er dan gebeurt. De schrijver gokt niet. Een bewering die nog niet kan worden gekoppeld aan een clausule die de schrijver werkelijk heeft gelezen, wordt behouden, gekoppeld aan materiaal in de repository en aan de standaardreferentie die de code zelf verklaart, expliciet als onopgelost gemarkeerd, en de pagina blijft ongepubliceerd totdat de clausule correct is geciteerd.

De verboden handelingen zijn opgesomd en controleerbaar: een clausulenummer dat is verzonnen om precies te lijken, een citatie die is opgemaakt alsof ze is gelezen terwijl ze uit het geheugen is geschreven, of het stilzwijgend verwijderen van de bewering om de citatie te ontwijken. Een correct gemarkeerde open citatie in een concept is schuld met een aantekening, geen defect. Een offline deterministische controle handhaaft precies dat onderscheid.

Praktisch voorbeeld

De discipline is concreet: ze zit in de structuur van de citations-front-matter van een pagina. Elke vermelding koppelt een bewering aan haar clausule.

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"

Er is bewust geen quote-veld. De topic is de eigen herformulering van NextPDF. De spec en clause zijn de manier waarop een reviewer terugkomt bij de exacte bron om die herformulering te controleren. De vermelding draagt de verwijzing naar de clausule, niet de bewoording van de clausule.

Veelvoorkomend misverstand

De valkuil is “parafraseer, citeer niet” lezen als een slag om de arm — een manier om gezaghebbend te klinken zonder zich vast te leggen. Het is precies andersom. Een citaat legt de schrijver nergens op vast; het leent de woorden van iemand anders. Een geciteerde parafrase legt de schrijver vast op een herformulering die een reviewer kan weerleggen aan de hand van de clausule. De discipline maakt beweringen beter verantwoord, niet minder.

De tweede valkuil is “editorial” behandelen als een zwakkere gradatie van “standard-backed”. Het is helemaal geen gradatie; het is een ander soort. Een redactionele pagina zoals deze ordent en verklaart ander materiaal. Ze is correct gelabeld. En het label is het punt: het systeem werkt omdat een pagina je vertelt op wat voor soort bron ze steunt voordat je beslist hoeveel gewicht je eraan geeft.

Grenzen en afbakening

Deze pagina specificeert de citatiediscipline; ze is niet het stijlblad of de gate-code. De gezaghebbende artefacten bevinden zich in de repository (docs/style/nextpdf-overrides.md §5 en de composer.jsondocs:*-scripts) en hebben voorrang op elke samenvatting hier als ze afwijken. Ze beweert geen enginegedrag.

De discipline bindt de bewering, niet de conclusie van de lezer. Een getrouw geciteerde parafrase vertelt je wat een clausule vereist. Of de lezing van NextPDF de juiste is voor je verplichting, blijft jouw beslissing, en daarom dragen gedragspagina’s ook code- of test-backed citaties, niet alleen standard-backed. Eerlijkheidshalve is de handhaving gedeeltelijk: de offline controle is actief, en de verbatim-quote- en live-citation-verifiers zijn aangesloten terwijl hun volledige uitvoerders nog worden afgerond — vermeld als in uitvoering, niet als voltooid.

Gerelateerde documentatie

Documentatie als product — de bredere kwaliteitsdiscipline waarvan dit citatiesysteem deel uitmaakt.
Het standaardenlandschap — de standaarden waarnaar deze citaten verwijzen, en hoe een clausule gedocumenteerd gedrag wordt.
De NextPDF-testpiramide — wat test-backed bewijs betekent wanneer een pagina op die grondslag steunt in plaats van op deze.

Woordenlijst

Citatiediscipline — het regelpakket dat bepaalt hoe een Insider_-bewering aan haar bron wordt gekoppeld: parafraseren, de exacte clausule benoemen, nooit een gelicentieerde standaard citeren.
Parafrase — een herformulering van een vereiste in de eigen stem van NextPDF, consistent met de woordenlijst; de begripstoets die citeren vervangt.
Clausuleverwijzing — de exacte clausule of sectie waarop een parafrase steunt, vastgelegd zodat een reviewer die kan openen en de herformulering kan verifiëren.
Standard-backed bewering — een bewering die is verankerd aan een geciteerde, geparafraseerde clausule van een benoemde standaard, in tegenstelling tot een die steunt op de code van de engine, een test, een meting of redactionele redenering.
Onopgeloste citatie — een bewering die nog niet kan worden gekoppeld aan een clausule die de schrijver heeft gelezen; behouden, als open gemarkeerd, en achtergehouden van publicatie in plaats van vervalst.