Kennis per domein, onderwerp en uitspraak, met een status per uitspraak

Context en probleemstelling

Architecten moeten snel zien wat vaststaat en wat nog een voorstel is, en in context kunnen reageren of besluiten. Dat vraagt een vaste structuur: kleine, zelfstandige uitspraken met een status, geordend naar onderwerp, en vaste namen in plaats van nummers en codes.

Beslisfactoren

• Iedere bewering is los te beoordelen, te bespreken en vast te stellen.
• Relaties zijn expliciet: van doel naar ontwerpkeuze, van ontwerpkeuze naar domein, van functie naar product.
• Namen in plaats van codes: een lezer begrijpt een verwijzing zonder opzoeken.
• Stabiele adressen, zodat reacties en besluiten blijven kloppen als tekst verandert.

Overwogen opties

1. Uitspraken per onderwerp, met een status per uitspraak — onderwerpen binnen domeinen, en losse concepten voor de dingen waarnaar zij verwijzen.
2. Doorlopende tekst per domein — leesbaar, maar niet per bewering vast te stellen.
3. Een grote tabel met eisen — goed te filteren, maar zonder samenhang en uitleg.

Besluit

Gekozen optie: “Uitspraken per onderwerp, met een status per uitspraak”.

• Strategie, aanbod, groeipad en platform zijn concepten met een eigen type: doelen, knelpunten, ontwerpkeuzes, beloften en toetsen; diensten, dienstprofielen en gebruikssituaties; de groeipadstappen; de soorten clusters en de servertypen. Functies en producten leggen vast welke producten welke functie invullen.
• Een domein beschrijft op hoofdlijnen wat het doet, zijn grens, zijn onderdelen met hun producten en hun samenhang. De uitwerking staat in onderwerpen (kennis/domeinen/<domein>/<onderwerp>.md).
• Een onderwerp heeft een korte tekst (wat het is, waarom zo) en uitspraken, gegroepeerd in thema’s. Iedere uitspraak heeft een vaste sleutel, een soort (uitgangspunt, regel, ontwerpbesluit, eis, maatregel, waarde, werking) en een status: vastgesteld (rust op een aanvaard besluit), voorgesteld (een voorstel) of vervallen.
• Het adres van een uitspraak is /domeinen/<domein>/<onderwerp>.md#u-<sleutel>; reacties en besluiten gebruiken dat adres.
• Een concept draagt een naam als id. Nummers en codes van eerdere lijsten komen niet voor.

Gevolgen

• Goed: de site toont per uitspraak haar status en de acties die erbij horen (reageren, aanpassen, besluit nemen).
• Goed: de validator bewaakt de samenhang: een vastgestelde uitspraak zonder aanvaard besluit is een fout.
• Slecht: meer kleine eenheden om bij te houden; thema’s en onderwerpen houden het overzicht.