Ursprünglich auf Französisch verfasst. Von KI übersetzt — der Sinn wurde bewahrt, nicht der Stil.
Hauptgedanke
Ein Produktglossar definiert Wörter, eines nach dem anderen: „Auftrag“, „Rechnung“, „Kunde“. Jeder Eintrag kann stimmen, und doch verrät das Ganze fast nichts darüber, was die Software tut. Ein Auftrag, der für sich allein beschrieben wird, bleibt ein Etikett. Derselbe Auftrag, der von einem Kunden erteilt wird, Positionen enthält und in einer Rechnung fakturiert wird, beschreibt ein Produkt — denn die Verben tragen, was das Fach erlaubt und was es verbietet.
Ein Referenzwerk, das seine Verknüpfungen benennt, unterscheidet sich damit von den drei Artefakten, die es rund um das Produkt schon gab: vom Glossar, das definiert, ohne zu verbinden; vom Datenbankschema, das Tabellen nach technischen Zwängen verbindet und nicht nach dem Fach; von der Dokumentation, die für menschliche Leser erzählt und keine abfragbare Struktur offenlegt.
Die praktische Vorgabe passt in eine einzige Schreibregel: Keine Verknüpfung lautet „ist verknüpft mit“. Jede trägt ein Verb und die Kardinalitäten auf beiden Seiten — ein Auftrag wird von genau einem Kunden erteilt, er enthält mindestens eine Position.
Warum das wichtig ist
Erst das macht die Beschreibung über das bloße Lesen hinaus nutzbar. Eine benannte Verknüpfung lässt sich prüfen, testen, widerlegen; „ist verknüpft mit“ lässt sich nie widerlegen und beweist deshalb nichts. Dadurch kann auch ein Agent eine Frage zum Verhalten des Produkts beantworten, ohne den Code zu öffnen: Die Antwort liegt im Pfad zwischen zwei Steckbriefen.
Und es liefert ein Abbruchkriterium für das Schreiben eines Steckbriefs: Solange die Verknüpfungen vage sind, ist der Steckbrief nicht geschrieben, auch wenn alle Felder ausgefüllt sind.
Nuancen und Grenzen
Das präzise Verb hat seinen Preis: Es zwingt dazu, Fälle zu entscheiden, die die Definition im Dunkeln ließ — wird ein automatisch erzeugter Auftrag von jemandem erteilt? Genau dieser Aufwand bringt Produktfragen ans Licht, aber er bremst den ersten Durchgang.
Und ein Netz korrekter Verknüpfungen sagt nichts über seine eigene Vollständigkeit: Eine Menge von Steckbriefen, die nur einander zitieren, schließt sich lange bevor sie das Produkt abgedeckt hat.
Offene Fragen
- Wie weit muss man das Vokabular der Verben selbst vereinheitlichen, bevor zwei Autoren aufhören, dieselbe Relation auf zwei verschiedene Arten zu benennen?