Citatiediscipline

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

In het kort

Dit is de pagina waarnaar de rest van Insider_ verwijst wanneer er sprake is van een “bewijsniveau”. Ze legt uit waarom deze documentatie standaarden parafraseert in plaats van citeert, hoe een bewering is gekoppeld aan een reference ID dat je opnieuw kunt verifiëren, en wat elk van de acht bewijsniveaus 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 voorziet die van een bewijsniveau. Dat stempel is alleen iets waard als het systeem 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 badge 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 controleerbaar maken aan de hand van haar bron, zonder die bron te reproduceren. Voor beide is het antwoord hetzelfde mechanisme, en deze pagina specificeert dat mechanisme.

De korte versie

Insider_ parafraseert standaarden en citeert nooit gelicentieerde standaarden. Een bewering vermeldt de standaard, de clausule en een reference ID; 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 draagt een 64 tekens lang reference_id in de citations-front-matter van de pagina, zodat de volgende reviewer exact dezelfde bronpassage opnieuw kan opvragen en de parafrase kan bevestigen.
De badge verklaart een bewijsniveau — een van acht soorten — dat het soort bewijs aangeeft, zodat een te sterke bewering in één oogopslag zichtbaar is.
Wanneer de bron niet kan worden opgehaald, wordt de bewering niet vervalst. Ze wordt behouden, in een re-pin-grootboek 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 vermeldt een pagina de standaard en clausule, parafraseert ze de vereiste in haar eigen stem, en legt ze het reference ID van de bron vast.

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 is gekoppeld aan een reference ID, niet aan een herinnering

Het mechanisme dat een parafrase controleerbaar maakt, is het reference ID. Elke standard-backed bewering draagt een volledig 64 tekens lang reference_id in de citations-front-matter van de pagina, dat de exacte bronpassage identificeert waaruit de parafrase is gemaakt. Een reviewer hoeft niet op het geheugen van de schrijver te vertrouwen; de reviewer haalt die passage opnieuw op en vergelijkt. Het reference ID is de verbinding tussen een niet-citeerbare bron en een verifieerbare bewering. Het geeft aan waar het bewijs zich bevindt zonder de tekst van het bewijs zelf mee te dragen.

Het bewijsniveau zegt wat voor soort bewijs dit is

Een citaat beantwoordt “waarvandaan”. Het bewijsniveau beantwoordt “welk soort”. Elke Insider_-pagina vermeldt er één, getoond in de badge-rij, gekozen uit een vaste set van acht. De vertrouwensvolgorde plaatst code en tests boven runtime, runtime boven metadata, en metadata boven proza; een redactionele pagina doet niet alsof ze code-backed is.

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

Deze pagina is Evidence: Editorial : ze beweert geen eigen enginegedrag. Ze legt het systeem uit waarop de badges van de andere pagina’s steunen. Dat is het passende niveau ervoor, en dat benoemen is de discipline toegepast op zichzelf.

Wanneer de bron niet kan worden opgehaald

Ophalen is niet altijd mogelijk. De integriteit van de discipline blijkt uit wat er dan gebeurt. Een normale wachtrij, snelheidslimiet of budgetpauze is geen storing. De schrijver wacht. Een echte storing activeert een gedocumenteerde terugvaloptie: de bewering wordt behouden, gekoppeld aan bewijs in de repository en aan de standaardreferentie die de code zelf verklaart, expliciet als onopgelost gemarkeerd in een lopend re-pin-grootboek, en de pagina blijft ongepubliceerd totdat het reference ID daadwerkelijk is vastgepind.

De verboden handelingen zijn opgesomd en controleerbaar: een verzonnen reference ID, een waarde die is opgevuld of voorzien van een prefix om echt te lijken, een uit het geheugen geschreven clausule vermomd als een opgehaald citaat, of het stilzwijgend verwijderen van de bewering om het citaat te ontwijken. Een correct gemarkeerde storing in een concept is schuld met een grootboekvermelding, geen defect. Een offline deterministische controle handhaaft precies dat onderscheid.

Wat het bewijs zegt

Deze pagina is Evidence: Editorial , dus haar eigen grondslag is de documentatiegovernance in deze repository plus de standaarden die de discipline rechtvaardigen. De beweringen hier zijn op twee manieren verifieerbaar: door de regels in de repository te lezen en door de geciteerde clausules opnieuw op te halen.

Bewering	Grondslag	Verankering
Parafraseren dwingt begrip af	Standaard	Heldere taal beoordeeld op gebruik door de lezer, niet op weerspiegeling van de bron Spec: ISO 24495-1, §Introduction
Terminologie blijft consistent	Standaard	Elke term wordt overal consistent gebruikt Spec: ISO/IEC/IEEE 26514, §8
Review is onderdeel van het proces	Standaard	Verificatie- en validatietests binnen de ontwikkeling Spec: ISO/IEC/IEEE 26513, §Foreword
Bewijsniveau is als eerste herkenbaar	Standaard	Herkenning boven herinnering Spec: ISO 9241-110, §5.6.2
Geen letterlijke gelicentieerde tekst; reference-pinned	In de repository	`docs/style/nextpdf-overrides.md` §5; `composer docs:jaccard-fingerprint`
Storingsterugval is een echt protocol	In de repository	De normatieve RAG-terugvalgovernance + de offline `docs:rag-fallback-check`-gate

Praktisch voorbeeld

De discipline is concreet: ze zit in de structuur van de citations-front-matter van een pagina. Elke vermelding is het bewijs van een bewering.

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"

Er is bewust geen quote-veld. De topic is de eigen herformulering van NextPDF. Het reference_id is de manier waarop een reviewer terugkomt bij de exacte bron om die herformulering te controleren. Het bewijs draagt de verwijzing naar het bewijs, niet de bewoording van het bewijs.

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 bron. 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 bewijs. Ze is correct gelabeld. En het label is het punt: het systeem werkt omdat een pagina je vertelt wat voor soort bewijs ze biedt voordat je beslist hoeveel gewicht je eraan geeft.

Grenzen en afbakening

Deze pagina specificeert de citatiediscipline; ze is niet het stijlblad, de terugvalgovernance of de gate-code. De gezaghebbende artefacten bevinden zich in de repository (docs/style/nextpdf-overrides.md §5, de normatieve RAG-terugvalgovernance, 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 bewijs, niet alleen standard-backed. Eerlijkheidshalve is de handhaving gedeeltelijk: de offline terugvalcontrole 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 dat niveau claimt in plaats van dit.

Woordenlijst

Citatiediscipline — het regelpakket dat bepaalt hoe een Insider_-bewering aan haar bron wordt gekoppeld: parafraseren, de clausule vermelden, een reference ID vastpinnen, 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.
reference_id — de volledige 64 tekens lange integriteitsverwijzing voor de exacte bronpassage waaruit een parafrase is gemaakt, vastgelegd zodat een reviewer die opnieuw kan opvragen en verifiëren.
Bewijsniveau — het verklaarde soort bewijs achter de beweringen van een pagina, een van acht (code-, standard-, test-, benchmark-, artifact-backed, design-principle, editorial, mixed), getoond in de badge-rij.
Onopgeloste citatie — een bewering waarvan het reference ID niet kon worden vastgepind door een echte ophaalstoring; behouden, gemarkeerd in een re-pin-grootboek, en achtergehouden van publicatie in plaats van vervalst.