Skip to content

Leesgids

Volgorde voor een eerste lezing

De hoofdstukken zijn zo geordend dat elk volgende hoofdstuk voortbouwt op het vorige.

  1. Schema-substraat — de fundering. Dutch-legal noun-families (hoe heet wat?), two-stack FRBR (waarom twee parallelle pijlers?), anker-protocol (hoe weten we dat onze schema-claims kloppen?).
  2. Manifestatie-laag — hoe de twee FRBR-pijlers elk hun eigen Manifestation-tabel hebben en hoe die via een junction aan elkaar gekoppeld worden voor bijlage-relaties.
  3. Expression-laag — versies van instrumenten: vastgesteld, gewijzigd, geconsolideerd, zakelijke weergave, mutatie. Hoe afgeleide Expressions structureel worden ondersteund.
  4. Registers-taxonomie — wat is OB, wat is niet-OB, en hoe classificeren we de verschillende vindplaatsen waar overheidsdocumenten leven.
  5. Corpus-evidence — welke wetten staan in wet.artikelen, welke artikelen ankeren welke schema-claim, en waar de gaps zitten.

Lezen op andere manieren

Niet iedereen leest van voor naar achter. Drie veel-voorkomende vragen en waar het antwoord zit:

VraagBegin hier
"Waarom heeft publicatie.publicaties geen instrument_version_id?"Manifestaties — waarom twee tabellen
"Wat valt onder OB en wat niet?"Registers — OB-grens
"Hoe weet je dat een schema-keuze juridisch klopt?"Schema-substraat — anker-protocol

Onderhoudsritme

Het handboek leeft mee met de architectuur. Na elke sessie waar een schema-beslissing wordt genomen:

  1. Beslissing zelf → ADR in docs/06-adr/ (formeel, kort).
  2. Narratief + evidence → een sub-pagina hier, in het juiste hoofdstuk.
  3. Pivots / inzichten → memory file project_schema_noun_families.md of een andere relevante memory.
  4. Voortgang / open punten → handoff in docs/handoffs/.

Vier plekken klinkt veel maar elk heeft een eigen functie:

  • ADR is machine-leesbaar-geneorienteerd (filename pattern, datum, status — voor agents en grep).
  • Handboek is mens-leesbaar-georiënteerd (verhaal, navigatie, evidence in context).
  • Memory is agent-context-georiënteerd (compact pivots die in context window passen).
  • Handoff is sessie-overdracht-georiënteerd (wat is gedaan, wat moet er nog).

Conventies

  • Nederlandstalig waar het over juridische concepten gaat (instrument, besluit, publicatie, manifestatie, expressie).
  • Code-blokken met SQL voor schema-vorm.
  • Tabellen voor evidence en mappings.
  • Citaten uit wet.artikelen met (✓ corpus) markering om aan te geven dat het corpus-geverifieerd is.
  • Niet alles is af; pagina's mogen markeren wat nog moet worden ingevuld.

Intern handboek — niet voor externe publicatie