KNOWLEDGE-STORIES-README
Knowledge Stories#
Präambel#
Jede Architekturentscheidung besitzt eine Geschichte.
Manche Geschichten handeln von erfolgreichen Projekten. Andere erzählen von Fehlern, Missverständnissen oder überraschenden Erkenntnissen. Gemeinsam haben sie, dass aus ihnen Wissen entstanden ist.
Die Knowledge Stories der Netzwerksolution dokumentieren diese Erfahrungen. Sie beschreiben keine Unternehmen und keine vollständigen Projektchroniken. Sie bewahren anonymisierte Beobachtungen, aus denen später wiederkehrende Muster und Architekturprinzipien abgeleitet werden können.
Aus Geschichten entstehen Muster. Aus Mustern entstehen Architekturprinzipien. Aus Architekturprinzipien entsteht die Wissensarchitektur der Netzwerksolution.
Knowledge Stories sind deshalb keine Anekdotensammlung. Sie bilden ursprüngliche Quellen der erfahrungsgetriebenen Architekturentwicklung.
Eine gute Geschichte erklärt ein Architekturprinzip besser als zehn Seiten Theorie.
Wir sammeln Geschichten nicht nur, weil sie interessant sind. Wir bewahren sie, weil in ihnen Wissen verborgen ist.
Grundsätze#
- Eine Knowledge Story beschreibt eine reale Erfahrung.
- Sie wird möglichst zeitnah erfasst.
- Die erzählende Person liefert den Inhalt.
- Die sprachliche Ausarbeitung verbessert Lesbarkeit, Reihenfolge und Anonymisierung.
- Tatsachen werden nicht ergänzt, verändert oder dramatisiert.
- Die redigierte Fassung wird gemeinsam geprüft.
- Unternehmen, Personen und vertrauliche Informationen werden anonymisiert.
- Eine Story wird nicht nachträglich an ein gewünschtes Pattern angepasst.
- Aus einer Story können mehrere Patterns entstehen.
- Eine Story besitzt selbst noch keine Architekturentscheidung.
Erfasste Stories#
- KS-0008 – Die Zustandsklassen waren keine Stationen
- KS-0007 – Ein Text für Architektur, Betrieb und Release
- KS-0006 – Der Plan, der zu groß wurde
- KS-0001 – Die Reinigungskraft und der CIO
- KS-0002 – Die Werbeplakate vor der Software
- KS-0003 – Das Flugzeug und die handschriftlichen Notizen
- KS-0004 – Der Fliesenleger
- KS-0005 – Die Geschichten der Maschine
Alle acht Stories besitzen derzeit den Reifegrad Story erfasst. Es wurden noch keine Knowledge Patterns verbindlich abgeleitet.