Sprachqualität

Sprachregeln

Gespräche, Tests, Ereignisse und spätere Modelle verwenden dieselben präzisen Begriffe.

12 Regelnfachlichprüfbar

Verbindliche Regeln

01

Zustand im Begriff nennen

Mehrdeutige Hauptwörter erhalten einen Zustand: Bestellentwurf, zugesagte Bestellung, versandbereit.

02

Anfrage, Entscheidung und Ergebnis trennen

Reservierungsanfrage, Reservierungsentscheidung und Bestandsreservierung sind nicht dasselbe.

03

Keine Autorisierung als Zahlung bezeichnen

In diesem Projekt bedeutet Zahlungsautorisierung nur die positive Reservierungsentscheidung des Providers.

04

Snapshots ausdrücklich benennen

Historische Bestell- und Rechnungswerte dürfen nie als aktuelle Produktdaten beschrieben werden.

05

Fachfehler und Störung trennen

Fachfehler sind belastbare Ergebnisse; technische Störungen lassen das Ergebnis gegebenenfalls offen.

06

Ereignisse in Vergangenheitsform

Ein Ereignis heißt Bestellung zugesagt oder Bestand reserviert, nicht Bestellung zusagen.

07

Idempotenz ist fachlich

Gleicher Schlüssel reicht nicht: Auch die fachliche Absicht muss identisch sein.

08

Kein globaler Status

Jeder Zustand gehört zu einem klar benannten fachlichen Gegenstand.

09

Lokale Bedeutung sichtbar machen

Ein lokal verwendeter Begriff trägt Perspektive und Definition; er wird nicht stillschweigend globalisiert.

10

Technik nicht als Fachsprache tarnen

HTTP, Kafka, Tabelle, Entity oder Queue dürfen keine fachliche Entscheidung erklären.

11

Synonyme kontrollieren

Zugelassene Synonyme sind dokumentiert; verbotene Alternativen werden in Reviews korrigiert.

12

Neue Begriffe brauchen Nachweis

Ein Begriff wird erst akzeptiert, wenn Definition, Beispiel, Gegenbeispiel und Use-Case-Bezug vorhanden sind.

Darstellung

Design
Text
Dichte
⌂ Cockpit