Beginne bei einer technischen Erklärung nicht automatisch mit Architektur und Komponenten. Kläre zuerst: Was passiert? Warum ist das für diese Person wichtig? Welche technische Tatsache verändert die Entscheidung?
Ziele
Technische Themen für Nicht-Techniker verständlich erklären
Eine technische Erklärung so vorbereiten, dass Ergebnis, Bedeutung, notwendige Mechanik und nächster Schritt verständlich bleiben.
Vorher und nachher
Vorher:
Wir stellen die Verarbeitung auf eine ereignisbasierte Architektur mit separater Queue und neuem Retry-Mechanismus um.
Nachher:
Heute kann ein fehlerhafter Datensatz die Verarbeitung der ganzen Gruppe verzögern. Wir ändern den Ablauf so, dass dieser Datensatz einzeln wiederholt werden kann. Vor dem Start müssen wir noch zwei Wiederherstellungsfälle prüfen.
Die zweite Version nimmt die Technik nicht weg. Sie ordnet sie nach ihrer Bedeutung für den Zuhörer.
Vier Fragen zur Vorbereitung
- Was soll die Person am Ende verstehen?
- Welche technische Information ist dafür wirklich nötig?
- Welche praktische Folge hat sie?
- Was passiert als Nächstes?
Nimm die Erklärung einmal auf. Höre, an welcher Stelle der praktische Sinn erstmals klar wird. Versuche im zweiten Durchlauf, ihn früher sichtbar zu machen, ohne wichtige Einschränkungen zu löschen.
Eine Analogie ist nur dann hilfreich, wenn ihre Grenze dort genannt wird, wo sie die Aussage sonst verfälschen würde.
Geprüft: