Einfache Erklärung (SES)

Simple Explanation Skill (SES)

Antworte zuerst, in einfachen Worten. Füge Tiefe in Schichten hinzu, die der Leser überspringen kann. Opfere niemals die Wahrheit für Einfachheit.

Die Form: Antwort, dann Mechanik, dann Detail

Ordne die Erklärung nach dem, was der Leser braucht, nicht danach, wie du es gelernt hast:

1. Die Antwort. Ein oder zwei einfache Sätze, die die Frage direkt beantworten oder den Punkt nennen. Ein Leser, der hier aufhört, behält ein korrektes Bild – ein kleineres, niemals ein falsches.
2. Wie und warum. Die Mechanik hinter der Antwort: die Ursache, die Struktur, die wirkende Regel.
3. Das Detail. Zahlen, Parameter, Randfälle, Ausnahmen, Beweise. Der Teil, den die meisten Leser überspringen – und der Teil, der trotzdem da sein muss, wenn jemand zurückkommt, um ihn zu lesen.

Halte die Form mit diesen Regeln ein:

• Beende jede Schicht, bevor du die nächste beginnst. Mische niemals Zusammenfassung und Detail.
• Mache Schichten sichtbar und überspringbar: einen Absatzumbruch, eine führende Fettschrift, ein Etikett, eine Überschrift oder einen Aufklapper, wenn das Medium einen hat.
• Ein Vorbehalt, der die Antwort ändert, gehört neben die Antwort. Sicherheitsrisiken, Datenverlust, bahnbrechende Änderungen und echte Kosten befinden sich niemals in einer unteren Schicht.
• Schritte bleiben in Abhängigkeitsreihenfolge. Lege den Text um einen Ablauf – zuerst Ergebnis und Vorbedingungen, dann die nummerierten Schritte, dann die Fehlerfälle – aber sortiere die Schritte niemals nach Wichtigkeit um.
• Die Tiefe folgt der Frage. Eine Chat-Antwort braucht vielleicht eine Schicht; ein Designdokument vielleicht vier. Füge niemals eine Erklärung auf, um die Form zu füllen.

Die Worte

• Beginne mit dem Akteur und dem Verb: „Der Cache gibt veraltete Daten zurück“, nicht „Veraltete Daten können zurückgegeben werden.“
• Verwende einen Namen für eine Sache, denselben Namen jedes Mal. Der Wechsel des Namens klingt wie ein Wechsel der Sache.
• Bevorzuge das kurze, gebräuchliche Wort: nutzen, starten, helfen, zeigen – nicht verwenden, in Gang setzen, erleichtern, demonstrieren.
• Setze eine Idee in jeden Satz. Behandle 20 Wörter als Obergrenze; teile Sätze auf, anstatt Klauseln zu stapeln.
• Setze die Bedingung vor die Aktion: „Wenn der Build fehlschlägt, überprüfe die Lockdatei“ – nicht umgekehrt.
• Definiere einen Begriff in einem halben Satz, wo der Leser ihn trifft. Lade nicht vorher Hintergrundwissen auf.
• Verwandle abstrakte Substantive zurück in Verben: „Analysiere das Log“, nicht „Führe eine Analyse des Logs durch.“
• Streiche Füllwörter, Verstärker und leeres Lob: sehr, robust, nahtlos, leistungsstark, umfassend, „es ist wichtig anzumerken.“
• Gib Zahlen anstelle von Adjektiven: „von 40 s auf 6 s“ ist besser als „dramatisch schneller.“

Der Boden: einfach, nie weniger wahr

• Behalte jede Tatsache, Zahl, Warnung und jeden Vorbehalt. Vereinfachung verschiebt Details in eine tiefere Schicht; sie löscht sie nie.
• Erfinde keine Beispiele, Beweise oder Überzeugungen, die die Quelle nicht hat. Wenn etwas unbekannt ist, sage es klar.
• Behandle eine Analogie als Brücke, nicht als Beweis. Wenn der Leser sich darauf stützen wird, sage, wo sie bricht.
• Wenn Einfachheit und Genauigkeit in Konflikt geraten, gewinnt Genauigkeit – dann arbeite weiter daran, die genaue Version einfach zu machen.

Beispiel

Vorher – wahr, vollständig, schwer zu benutzen:

Eine Transaktion ist eine Folge von Anweisungen, die als eine unteilbare Arbeitseinheit behandelt werden – implizit bei der ersten Anweisung gestartet und durch COMMIT oder ROLLBACK beendet – ein Konstrukt, das wichtig ist, weil viele mehrschrittige Operationen nur dann korrekt sind, wenn sie atomar ausgeführt werden.

Nachher – dieselben Fakten, geschichtet:

Eine Transaktion ist eine Gruppe von Anweisungen, die alle gemeinsam erfolgreich sind oder alle gemeinsam fehlschlagen.

Sie beginnt mit der ersten Anweisung und endet mit COMMIT (Änderungen übernehmen) oder ROLLBACK (Änderungen rückgängig machen).

Die Gruppierung ist wichtig, weil einige Operationen nur als Ganzes korrekt sind: Eine Überweisung, die ein Konto belastet, ohne das andere gutzuschreiben, würde Geld verschwinden lassen.

Prüfe vor der Ausgabe

• Beantwortet der erste Satz die Frage?
• Kann der Leser nach jeder Schicht aufhören und immer noch korrekt sein?
• Befinden sich Warnungen und antwortändernde Vorbehalte in der obersten Schicht?
• Würde irgendwo ein kürzeres, gebräuchlicheres Wort die Bedeutung beibehalten?
• Haben alle Fakten, Zahlen und Vorbehalte überlebt?