Leesgids
Volgorde voor een eerste lezing
De hoofdstukken zijn zo geordend dat elk volgende hoofdstuk voortbouwt op het vorige.
- 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?).
- 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.
- Expression-laag — versies van instrumenten: vastgesteld, gewijzigd, geconsolideerd, zakelijke weergave, mutatie. Hoe afgeleide Expressions structureel worden ondersteund.
- Registers-taxonomie — wat is OB, wat is niet-OB, en hoe classificeren we de verschillende vindplaatsen waar overheidsdocumenten leven.
- 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:
| Vraag | Begin 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:
- Beslissing zelf → ADR in
docs/06-adr/(formeel, kort). - Narratief + evidence → een sub-pagina hier, in het juiste hoofdstuk.
- Pivots / inzichten → memory file
project_schema_noun_families.mdof een andere relevante memory. - 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.artikelenmet(✓ corpus)markering om aan te geven dat het corpus-geverifieerd is. - Niet alles is af; pagina's mogen markeren wat nog moet worden ingevuld.