Idee

Ein Softwareobjekt ist erst beschrieben, wenn es im Kern des Codes, in der Datenbank, in den Oberflächen und in den Übersetzungen gelesen wurde

Info

Ursprünglich auf Französisch verfasst. Von KI übersetzt — der Sinn wurde bewahrt, nicht der Stil.

Hauptgedanke

Ein und dasselbe Objekt wird an vier Orten eines Produkts beschrieben, und jeder sagt, was die anderen verschweigen. Der Kern des Codes enthält die Regeln — was verboten ist, was verpflichtend ist, was was auslöst. Die Datenbank enthält die Felder, die Eindeutigkeit, das, was nicht leer bleiben darf. Die Oberflächen enthalten die Eingabeprüfungen, die Felder, die nur unter Bedingungen erscheinen, die ausgegrauten Schaltflächen, die Auswahllisten. Die Übersetzungen enthalten die Wörter, die dem Nutzer tatsächlich angezeigt werden, in allen Sprachen.

Eine Regel kann sehr wohl nur an einem dieser vier Orte stehen. Wer den Kern des Codes liest und dort aufhört — der natürlichste Reflex, bei einem Entwickler wie bei einem Agenten —, gibt also eine Beschreibung heraus, die vollständig aussieht und es nicht ist.

Daraus folgt eine Lesereihenfolge: die Oberflächen nach dem Code und bevor man das Thema schließt. Der Abgleich geschieht Objekt für Objekt, nie Ordner für Ordner, weil sich der Zuschnitt der Oberfläche nicht mit dem des Servers deckt.

Warum das wichtig ist

Das ist eine Abschlussbedingung, die man einfordern kann: „Dieser Bereich ist fertig“ wird Zeile für Zeile überprüfbar, eine Zeile pro Bereich und Ort, statt bloß behauptet zu werden. Eine Nachverfolgung in dieser Körnung übersteht die Unterbrechung der Arbeit und verhindert, dass man dasselbe zweimal liest.

Und erst das stellt die vier Quellen nebeneinander und macht so ihre Widersprüche sichtbar.

Nuancen und Grenzen

Das Kriterium misst die Tiefe, nie die Breite. Man kann bei einer Minderheit der Bereiche des Produkts alle vier Orte gelesen haben und den ganzen Rest übersehen — dann ist die Regel tadellos eingehalten und die Arbeit sehr unvollständig.

Die Zahl vier ist kein Gesetz: Sie entspricht den Orten, an denen genau dieses Produkt Informationen ablegt. Eine andere Architektur — Nachrichten zwischen Diensten, eine ausgelagerte Regel-Engine — brächte weitere hinzu.

Offene Fragen

  • Wie erkennt man bei einer unbekannten Architektur die Liste der Orte, an denen sich Information ablagert, bevor man begonnen hat, sie zu lesen?