Blueprint · Die Seite der Leser
Kognitionspsychologie für die Technische Kommunikation
Der Reader’s Stack: wie Leser technische Information aufnehmen, verstehen und danach handeln
Dokumentation wirkt im Kopf der Leser, nicht auf dem Papier.
- Von
- Von Saina Veigel · Communications Specialist · Senior Technical Writer
- Ausgabe
- 2
- Zuerst veröffentlicht
- Geprüft
Der Blueprint „Denkmodelle für Technische Redakteure“ beschreibt, wie Technische Redakteure Komplexität strukturieren, bevor sie schreiben. Das ist der Stack der Redakteure. Dieser Blueprint beschreibt die andere Seite: was geschieht, wenn die Dokumentation bei den Lesern ankommt. Das ist der Reader’s Stack.
Dokumentation wirkt nicht auf dem Papier. Sie wirkt im Kopf der Leser.
Ein Leser muss die Information bemerken, sie finden, wissen, wo er ist, sie verstehen, sich ein Modell des Systems bilden, die Schritte im Kopf behalten, sich später an Wichtiges erinnern, entscheiden, handeln und den sicheren Zustand wiederherstellen, wenn etwas schiefgeht. Jeder dieser Vorgänge ist ein kognitiver Prozess. Die Kognitionspsychologie untersucht sie seit Jahrzehnten. Das meiste dieses Wissens erreicht das Dokumentationsteam selten.
Bei jedem Dokumentationsprozess wird geprüft, ob der Text korrekt ist. Diese Vorlage fügt eine zweite Prüfung hinzu: Was muss im Kopf des Lesers vor sich gehen, damit der Text seine Wirkung entfaltet? Um diese Frage zu beantworten, muss man sich auf das Wissen über die menschliche Kognition stützen – hier trifft technisches Schreiben auf kognitive Psychologie.
Warum die Denkweise des Lesers eine Rolle spielt
Die Denkweise des Lesers spielt eine Rolle, da Dokumentation niemals unter idealen Bedingungen gelesen wird.
Autoren (oder Redakteure) kennen den Inhalt, den Aufbau und die Absicht jedes einzelnen Satzes. Leser wissen davon nichts. Sie kommen mit einem Ziel, einem Problem oder einer Fehlermeldung – und mit begrenzter Aufmerksamkeit, begrenzter Zeit und begrenztem Arbeitsgedächtnis.
Die Situation des Lesers umfasst in der Regel:
- eine Aufgabe, die schon läuft
- eine Maschine, ein Bildschirm oder ein Panel, das um Aufmerksamkeit konkurriert
- Lärm, Handschuhe, schlechtes Licht oder ein kleines Display
- Zeitdruck aus der Produktion oder vom Kunden
- Vorwissen, das teils stimmt und teils nicht
- Gewohnheiten von einem ähnlichen Produkt
- Unterbrechungen
- Stress nach einer Störung oder einem Alarm
- eine Zweitsprache
- Erinnerungen an das letzte Mal, als es gut ging
Nichts davon ist im Quelltext erkennbar. Es wird erst sichtbar, wenn der Autor die Perspektive des Lesers einnimmt.
Technische Redakteure benötigen keine psychologische Ausbildung. Sie sollten jedoch wissen, was der Menschenverstand mit Informationen anfangen kann und was nicht, und die Dokumentation entsprechend gestalten. Der „Reader’s Stack“ liefert diese Struktur.
Das Kernproblem
Viele Dokumentationsprobleme sehen aus wie Schreibprobleme, sind aber Kognitionsprobleme.
- Eine Warnung wird vielleicht übersehen, weil sie nie Aufmerksamkeit erreicht hat – nicht, weil sie schlecht formuliert war.
- Ein Topic wird vielleicht nie gelesen, weil seine Überschrift keine Fährte zu seinem Inhalt gelegt hat.
- Eine Handlungsanweisung scheitert vielleicht, weil sie den Leser zu viel auf einmal im Kopf behalten lässt.
- Ein Konzept wird vielleicht missverstanden, weil es dem vorhandenen Modell des Lesers vom System widerspricht.
- Ein Abschnitt zur Fehlersuche hilft vielleicht nicht, weil er ruhiges Nachdenken in einem Moment des Stresses voraussetzt.
Wird die Kognition der Leser übergangen, scheitert auch richtiger Text. Korrekte Inhalte können Information nicht ausgleichen, die der Kopf nicht aufnehmen kann.
Blueprints
Der Reader’s Stack
Wie Dokumentation im Kopf der Leser wirkt
Der Reader’s Stack ist die praktische Struktur hinter diesem Blueprint. Technische Redakteure können mit ihm Dokumentation von der Seite der Leser her prüfen: zehn Leserebenen, jede mit ihrer Kernfrage und den Dokumentationsentscheidungen, die sie prägt. Die Ebenen sind keine starre Reihenfolge. Leser bewegen sich zwischen ihnen hin und her.
Seitlich scrollen, um alle Spalten zu sehen.
| Leserebene | Kernfrage | Dokumentationsentscheidung |
|---|---|---|
| Bemerken | Wird der Leser diese Information überhaupt bemerken? | Platzierung · Auffälligkeit · Signalwort · Layout · Häufigkeit von Warnungen |
| Finden | Kann der Leser die Information finden, die er braucht? | Überschriften · Einstiegspunkte · Navigation · Index · Suchbegriffe · Informationsfährte |
| Sich orientieren | Weiß der Leser, wo er ist und was für ihn gilt? | Kontextangabe · Gültigkeit · Überblick · Seitentyp · Gruppierung · Brotkrumenpfad |
| Verstehen | Kann der Leser die Bedeutung aufbauen, die die Redakteurin gemeint hat? | Terminologie · Satzbau · Beispiele · Definitionen · ausdrückliche Zusammenhänge |
| Modell bilden | Passt das Modell des Lesers dazu, wie das System funktioniert? | Konzeptinformation · Systemüberblick · Ursache und Wirkung · Zustände · Abbildungen · Reihenfolge von Konzept und Handlung |
| Im Kopf behalten | Kann der Leser im Kopf behalten, was dieser Schritt verlangt? | Schrittgröße · Chunking · Werte am Schritt · Verbindung von Bild und Text · geteilte Aufmerksamkeit |
| Erinnern | Woran muss sich der Leser später erinnern, und was kann auf der Seite bleiben? | Arbeitshilfen · Erinnerungen am Ort der Nutzung · Wiedererkennen statt Abrufen · Wiedereinstiegspunkte · Schulungsinhalte |
| Entscheiden | Kann der Leser mit dieser Information die richtige Entscheidung treffen? | Entscheidungskriterien · Bedingungen · Folgen · Risikokommunikation · Abbruchkriterien |
| Handeln | Kann der Leser die Information in die richtige Handlung umsetzen? | Handlungsanweisung · Handlungsverben · eine Handlung pro Schritt · Rückmeldung und Ergebnis · Checkliste · Arbeitshilfe |
| Wiederherstellen | Kann der Leser einen Fehler erkennen und in einen sicheren Zustand zurückkehren? | Fehlersuche · Symptome und Ursachen · Fehlermeldungen · Schritte zur Behebung · Eskalation · Bedingungen für den Wiederanlauf |
Diese Tabelle ist keine Theorie des Geistes. Sie ist eine Prüfliste der Stellen, an denen Dokumentation im Kopf der Leser scheitern kann.
Dokumentation wirkt im Kopf der Leser, nicht auf dem Papier.
Die Perspektive der Nutzungssituation · Referenz
Das Raster zur Analyse von Nutzungssituationen
Jede Nutzungssituation wird entlang derselben kognitiven Dimensionen untersucht, bevor über die Dokumentation entschieden wird
Die Tabelle veranschaulicht, wie sich die Informationsbedürfnisse des Lesers verändern, sobald die Dokumentation mit einer konkreten Anwendungssituation verknüpft wird. Derselbe Leser benötigt möglicherweise in der ersten Stunde mit einem Produkt, im Routinebetrieb und nach einer Störung ganz unterschiedliche Informationen. Technische Redakteure fragen nicht nur, wer der Leser ist. Sie fragen auch, in welchem Zustand hinsichtlich Aufmerksamkeit, Zeit und Stress der Leser auf die Informationen trifft.
Seitlich scrollen, um alle Spalten zu sehen.
| Nutzungssituation | Leser und Vorwissen | Bedingungen der Aufmerksamkeit | Zeitdruck und Stress | Kognitive Anforderung | Wahrscheinliche Fehlerart | Informationsbedarf | Dokumentationsentscheidung |
|---|---|---|---|---|---|---|---|
| Erstnutzung | Neuer Benutzer · wenig oder übertragenes Vorwissen | Der Fokus liegt auf dem Produkt, noch nicht auf der Dokumentation | Geringe bis mäßige · Unsicherheit | Erstellung eines ersten Modells des Systems | Fehler aufgrund eines falschen oder übernommenen Modells | Was ist das, was macht es, was kommt zuerst? | Konzept vor Handlung · Überblick · Einstiegspfad · klare erste Schritte |
| Routinebetrieb | Geschulter Benutzer · starke Gewohnheiten | Gespalten · Dokumentation wird selten herangezogen | Gering · aber Produktionsdruck | Fertigkeitsbasiertes Verhalten · geringe bewusste Steuerung | Patzer und Fehltritte · Gewöhnung an Warnungen | Kurze Bestätigung · Grenzen und Werte | Nachschlagetabelle · Kurzübersicht · Arbeitshilfe · Warnungen sind konkret und selten gehalten |
| Einrichten / Umrüsten (Umstellen) | Geschulter Benutzer · Aufgabe wird gelegentlich ausgeführt | Aufteilung in Maschine, Parameter und Dokumentation | Mittel · die Umrüstzeit zählt | Viele Werte zu beachten · Reihenfolge ist wichtig | Aussetzer · ausgelassene Schritte · falscher Parameter | Reihenfolge, Werte, Prüfungen | Kurze, nummerierte Schritte · Angaben zu den einzelnen Schritten · Checkliste · Bestätigung nach kritischen Schritten |
| Fehlersuche unter Zeitdruck | Bediener oder Techniker · Teilwissen über die Störung | Auf Fehlermeldung eingegrenzt | Hoch · Stress | Symptomdiagnose · regelbasiertes Verhalten | Fehler aufgrund von Fehldiagnosen · unsichere Abkürzungen | Was bedeutet das Symptom? Was sollte ich zuerst überprüfen? Wann sollte ich Prüfung beenden? | Einstieg über Symptom oder Meldung · Entscheidungsschritte · Warnung vor dem Eingriff · Eskalationspunkt |
| Notfall | Alle Anwesenden · möglicherweise ohne entsprechende Schulung | Tunnelblick · Dokumentation kaum nutzbar | Sehr hoch · akuter Stress | Minimal · nur eingeübte Handlungen funktionieren | Einfrieren · falsche Handlung · Unterlassung | Eine sofortige Handlung / Maßnahme | Informationen an der Maschine und im Rahmen der Schulung, nicht nur im Handbuch · Schilder · kurze, eindeutige Anweisungen |
| Instandhaltung durch Fachleute | Spezialist · fundiertes Fachwissen | Fokussiert · selektives Lesen | Mittel | Wissensbasiertes Denken bei seltenen Aufgaben | Selbstüberschätzung · ausgelassene Überprüfungen · Umkehrung der Fachkompetenz | Genaue Daten, Abweichungen, Voraussetzungen | Referenzdaten · Voraussetzungen werden zuerst genannt · keine Füllangaben · Prüfungen, die nicht unbemerkt übersprungen werden können |
| Einarbeitung und Schulung | Lernender · noch kein Modell | Verfügbar · Lesen, um zu lernen | Gering | Schemata aufbauen · hohe intrinsische Last | Hartnäckige Vorurteile bzw. falsche Vorstellungen | Warum es so funktioniert, wie die Teile zusammenhängen | Vorbereitende Strukturierung · Beispielaufgaben · Verknüpfung von Konzepten und Aufgaben · Üben vor dem Nachschlagen |
Das Schema kann in Verbindung mit dem Betriebsmodus-Analyseschema des Leitfadens „Denkmodelle für technische Redakteure“ gelesen werden. Das Betriebsmodus-Schema befasst sich mit der Frage, was die Maschine tut und welche Risiken bestehen bleiben. Dieses Schema befasst sich hingegen mit der Frage, in welchem Zustand der Leser auf die Informationen trifft. Beide fließen in dieselbe Dokumentationsentscheidung ein.
Derselbe Leser in einer anderen Situation braucht eine andere Dokumentation.
Abgleich · Ausgabe 1 und der Reader’s Stack
Stack der Redakteure und Stack der Leser
Welchen Leserebenen jede Denkebene der Redakteure dient
Der Blueprint „Denkmodelle für Technische Redakteure“ beschreibt zehn Denkebenen auf der Seite der Redakteure. Jede von ihnen bereitet Entscheidungen vor, die auf der Seite der Leser wirken. Der Abgleich zeigt, welchen Leserebenen jede Ebene der Redakteure vor allem dient.
Seitlich scrollen, um alle Spalten zu sehen.
| Ebene der Redakteure (Ausgabe 1) | Leserebenen, denen sie dient | Was die Redakteurin für die Leser entscheidet |
|---|---|---|
| Denken in ersten Prinzipien | Verstehen · Modell bilden | Was der Leser zuerst erfassen muss, damit alles andere Sinn ergibt |
| Information Mapping | Finden · Sich orientieren | Informationsarten, die der Leser auf einen Blick erkennt und an der richtigen Stelle erwartet |
| Komponentendenken | Finden · Im Kopf behalten | Einheiten mit einem Zweck, die für sich gelesen und genutzt werden können |
| Systemdenken | Modell bilden · Sich orientieren | Kontext, Grenzen und Beziehungen, damit das Modell des Lesers zum System passt |
| Aufgabendenken | Handeln · Im Kopf behalten · Erinnern | Schritte, die ins Arbeitsgedächtnis passen, mit Voraussetzungen und sichtbaren Ergebnissen |
| Risikodenken | Bemerken · Entscheiden · Wiederherstellen | Warnungen im Moment der Handlung, Abbruchkriterien und sichere Behebung |
| Variantendenken | Sich orientieren · Entscheiden | Sichtbare Gültigkeit, damit der Leser weiß, dass die Information für ihn gilt |
| Metadatendenken | Finden · Sich orientieren | Bezeichnungen, Filter und Gültigkeitsangaben, die eine Informationsfährte legen |
| Denken in Publikationslogik | Finden · Erinnern | Reihenfolge und Kanal, die die Information dorthin bringen, wo der Leser ist |
| Klarheitsdenken | Verstehen · Im Kopf behalten | Begriffe, Formulierung und Reihenfolge, die die Last aus der Darstellung verringern |
Der Abgleich ist keine Eins-zu-eins-Zuordnung. Jede Ebene der Redakteure berührt mehrere Leserebenen; die Tabelle nennt diejenigen, denen sie am unmittelbarsten dient.
Der Stack der Redakteure baut die Struktur. Der Stack der Leser zeigt, ob sie wirkt.
Die zehn Leserebenen
Jede Ebene des Reader’s Stack ist eine Stelle, an der Dokumentation im Kopf der Leser wirken muss – und eine Stelle, an der sie scheitern kann.
- Bemerken
- Finden
- Sich orientieren
- Verstehen
- Modell bilden
- Im Kopf behalten
- Erinnern
- Entscheiden
- Handeln
- Wiederherstellen
1. Bemerken
Kernfrage: Wird der Leser diese Information überhaupt bemerken?
Bemerken heißt, dass Information die Aufmerksamkeit des Lesers erreicht, bevor irgendetwas anderes geschehen kann.
Technische Redakteure müssen fragen:
- Wo ist die Aufmerksamkeit des Lesers in diesem Moment?
- Was konkurriert mit der Dokumentation um Aufmerksamkeit?
- Hebt sich die wichtigste Information vom Rest ab?
- Steht die Warnung dort, wo der Leser vor dem Handeln hinschaut?
- Gibt es so viele Warnungen, dass keine mehr bemerkt wird?
- Trennt das Layout Sicherheitsinformation von gewöhnlichen Hinweisen?
Aufmerksamkeit ist selektiv. Die Forschung zur selektiven Aufmerksamkeit, von Donald Broadbent (1958) und Anne Treisman (1964) an, zeigt, dass Menschen nur einen kleinen Teil dessen verarbeiten, was ihre Sinne erreicht. Information, die sich nicht abhebt oder dort erscheint, wo der Leser nicht hinschaut, wird oft gar nicht verarbeitet.
Arien Mack und Irvin Rock (1998) beschrieben die Unaufmerksamkeitsblindheit, Daniel Simons und Christopher Chabris (1999) führten sie vor: Menschen übersehen selbst auffällige Ereignisse, wenn ihre Aufmerksamkeit bei einer Aufgabe ist. Die Warnforschung ergänzt die Gewöhnung – eine Warnung, die zu oft gesehen wird, verliert ihre Wirkung.
Für die Dokumentation heißt das: Eine richtige Warnung, die nicht bemerkt wird, schützt niemanden. Platzierung, Auffälligkeit und Zurückhaltung sind Dokumentationsentscheidungen, keine Gestaltungsdetails.
- Bemerken ist nicht Verstehen.
- Sichtbar ist nicht dasselbe wie gesehen.
- Mehr Warnungen bedeuten nicht mehr Aufmerksamkeit.
- Fettdruck ist keine Auffälligkeit.
Information, die nie bemerkt wird, existiert für den Leser nicht.
Dokumentationsentscheidung
- Platzierung
- Auffälligkeit
- Signalwort
- Layout
- Häufigkeit von Warnungen
2. Finden
Kernfrage: Kann der Leser die Information finden, die er braucht?
Finden heißt, dass Leser von ihrer Frage zur richtigen Stelle in der Dokumentation gelangen.
Technische Redakteure müssen fragen:
- Mit welcher Frage, welchem Symptom oder welchem Wort kommt der Leser an?
- Verwenden die Überschriften die Wörter der Leser oder die Wörter der Entwicklung?
- Sagt jede Überschrift, was hinter ihr steht?
- Welche Einstiegspunkte gibt es: Inhaltsverzeichnis, Index, Suche, Fehlercode, Symbol?
- Kann der Leser schnell erkennen, dass eine Seite die falsche ist?
- Wie viele Schritte liegen zwischen der Frage und der Antwort?
Leser lesen Technische Dokumentation selten von vorn bis hinten. Sie suchen. Peter Pirolli und Stuart Card (1999) beschrieben das als Information Foraging: Menschen folgen der Informationsfährte von Überschriften, Links und Bezeichnungen und geben einen Weg auf, wenn die Fährte schwächer wird.
Überfliegen ist kein Versagen des Lesers. Es ist die normale Art, nach Information zu suchen. Die verbreitete Behauptung, „niemand liest“, ist zu einfach: Menschen überfliegen, um zu entscheiden, wo sie lesen, und lesen dann genau.
Für die Dokumentation heißt das: Die Struktur muss für jemanden funktionieren, der mittendrin einsteigt, mit seinen eigenen Wörtern und mit wenig Geduld.
- Finden ist nicht Lesen.
- Ein Inhaltsverzeichnis ist keine Suchstrategie.
- Eine Überschrift ist ein Versprechen über das, was folgt.
Information, die nicht gefunden wird, ist so nutzlos wie Information, die nie geschrieben wurde.
Dokumentationsentscheidung
- Überschriften
- Einstiegspunkte
- Navigation
- Index
- Suchbegriffe
- Informationsfährte
3. Sich orientieren
Kernfrage: Weiß der Leser, wo er ist und was für ihn gilt?
Sich orientieren heißt, dass Leser erkennen, wo sie sind, wofür diese Information da ist und ob sie für ihr Produkt und ihre Situation gilt.
Technische Redakteure müssen fragen:
- Weiß der Leser, welches Produkt, welche Variante und welche Betriebsart diese Seite behandelt?
- Sagt die Seite, welche Art von Information sie ist?
- Ist klar, was der Leser vorher gelesen oder getan haben sollte?
- Gruppiert das Layout, was zusammengehört?
- Sieht der Leser die Struktur vor den Details?
- Kann ein Leser, der über die Suche kommt, erkennen, wo diese Seite im Ganzen steht?
Leser verstehen neue Information über das, was sie schon wissen. Frederic Bartlett (1932) beschrieb Schemata als geordnetes Vorwissen; John Bransford und Marcia Johnson (1972) zeigten, dass derselbe Text viel leichter zu verstehen und zu behalten ist, wenn Leser sein Thema vorher kennen. David Ausubel (1960) schlug aus diesem Grund Advance Organizer vor.
Auch die Wahrnehmung gruppiert, was sie sieht. Die von Max Wertheimer (1923) beschriebenen Gestaltprinzipien – Nähe, Ähnlichkeit, gemeinsame Region – entscheiden, welche Elemente einer Seite ein Leser als Einheit auffasst.
Für die Dokumentation heißt das: Kontext, Gültigkeit und Art der Information müssen vor dem Inhalt sichtbar sein, und das Layout muss die Struktur zeigen, die der Text meint.
- Orientierung ist nicht Navigation.
- Eine Seite ohne Kontext zwingt den Leser zum Raten.
- Gültigkeit ist Information, nicht nur Metadaten für die Redakteurin.
Leser, die wissen, wo sie sind, können verstehen, was sie lesen.
Dokumentationsentscheidung
- Kontextangabe
- Gültigkeit
- Überblick
- Seitentyp
- Gruppierung
- Brotkrumenpfad
4. Verstehen
Kernfrage: Kann der Leser die Bedeutung aufbauen, die die Redakteurin gemeint hat?
Verstehen heißt, dass Leser aus dem Text die gemeinte Bedeutung aufbauen – und nicht nur seine Wörter entschlüsseln.
Technische Redakteure müssen fragen:
- Welche Schlussfolgerungen überlässt der Text dem Leser?
- Welche dieser Schlussfolgerungen kann der Leser tatsächlich ziehen?
- Werden Begriffe einheitlich verwendet, oder hat eine Sache mehrere Namen?
- Werden Ursachen, Bedingungen und Folgen ausdrücklich genannt?
- Zeigt ein Beispiel, was die abstrakte Aussage bedeutet?
- Käme ein Leser mit weniger Vorwissen zur selben Bedeutung?
- Ist der Text auf dem Sprachniveau der Leser lesbar und, wenn nötig, auch in der Übersetzung?
Leseverstehen ist Konstruktion. Teun van Dijk und Walter Kintsch (1983) unterschieden den Text selbst vom Situationsmodell, das Leser daraus aufbauen; Kintschs Konstruktions-Integrations-Modell (1988) beschreibt, wie Leser den Text mit ihrem Wissen verbinden und Lücken durch Schlussfolgerungen füllen.
Schlussfolgerungen kosten Mühe und können danebengehen. Leser mit weniger Vorwissen ziehen weniger davon, Leser mit falschem Vorwissen ziehen die falschen. Lesbarkeitsformeln messen Wort- und Satzlänge; sie messen nicht, ob das gemeinte Situationsmodell erreicht wird.
Für die Dokumentation heißt das: Was der Leser erschließen muss, muss erschließbar sein, und was nicht missverstanden werden darf, muss ausdrücklich gesagt werden.
- Verstehen ist nicht Entschlüsseln.
- Ein kurzer Satz ist nicht automatisch ein klarer.
- Was die Redakteurin selbstverständlich findet, muss der Leser erschließen.
Der Text liefert das Material. Die Bedeutung baut der Leser.
Dokumentationsentscheidung
- Terminologie
- Satzbau
- Beispiele
- Definitionen
- ausdrückliche Zusammenhänge
5. Modell bilden
Kernfrage: Passt das Modell des Lesers dazu, wie das System funktioniert?
Modell bilden heißt, dass Leser ein funktionierendes Modell des Produkts oder Systems aufbauen, mit dem sie vorhersagen können, was geschehen wird.
Technische Redakteure müssen fragen:
- Welches Modell des Systems bringt der Leser mit?
- Wo weicht dieses Modell davon ab, wie das System tatsächlich funktioniert?
- Welches Konzept muss der Leser erfassen, bevor eine Handlung Sinn ergibt?
- Erklärt die Dokumentation Zustände, Betriebsarten und ihre Übergänge?
- Kann der Leser vorhersagen, was das System nach seiner Handlung tun wird?
- Zeigt eine Abbildung die Zusammenhänge, die der Text beschreibt?
Philip Johnson-Laird (1983) beschrieb mentale Modelle als innere Repräsentationen, mit denen Menschen schlussfolgern und vorhersagen. Donald Norman (1983, 1988) übertrug die Idee auf Produkte: Der Entwickler hat ein Modell, der Benutzer bildet ein anderes, und die einzige Brücke zwischen beiden ist das System Image – das Produkt, seine Bedienoberfläche und seine Dokumentation.
Norman beschrieb auch die Kluft der Ausführung und die Kluft der Bewertung: den Abstand zwischen dem, was Benutzer tun wollen, und dem, was das System sie tun lässt, und zwischen dem, was das System zeigt, und dem, was Benutzer deuten können. Dokumentation ist Teil des System Image. Sie kann diese Klüfte verkleinern oder vergrößern.
Für die Dokumentation heißt das: Konzeptinformation ist kein Hintergrund. Sie baut das Modell auf, das Handlungen verständlich und Fehler vorhersehbar macht.
- Eine Handlungsanweisung ist kein Modell.
- Ein falsches Modell übersteht richtige Schritte.
- Konzeptinformation gehört vor die Handlung, nicht hinter die Störung.
Leser handeln nach ihrem Modell des Systems, nicht nach dem System selbst.
Dokumentationsentscheidung
- Konzeptinformation
- Systemüberblick
- Ursache und Wirkung
- Zustände
- Abbildungen
- Reihenfolge von Konzept und Handlung
6. Im Kopf behalten
Kernfrage: Kann der Leser im Kopf behalten, was dieser Schritt verlangt?
Im Kopf behalten heißt, dass die Information, die ein Leser in einem Moment braucht, in das Arbeitsgedächtnis passt.
Technische Redakteure müssen fragen:
- Wie viel muss der Leser im Kopf behalten, um diesen Schritt auszuführen?
- Enthält ein Schritt mehrere Handlungen?
- Muss der Leser zu einer früheren Seite, Tabelle oder Abbildung zurückblättern?
- Stehen die Beschriftungen an der Abbildung oder in einer getrennten Legende?
- Stehen Werte, Einstellungen und Grenzen dort, wo sie gebraucht werden?
- Welche Information lässt sich zu einer sinnvollen Einheit bündeln?
- Was ist zusätzliche Mühe, die nur durch die Darstellung entsteht?
Alan Baddeley und Graham Hitch (1974) beschrieben das Arbeitsgedächtnis als begrenztes System zum Halten und Verarbeiten von Information. George Millers „magische Zahl sieben, plus oder minus zwei“ (1956) wird oft als Regel für die Länge von Listen zitiert; Nelson Cowan (2001) kam zu dem Schluss, dass die Grenze eher bei etwa vier Einheiten liegt – und dass vom Vorwissen abhängt, was als Einheit zählt. Keines von beiden ist eine Regel für die Zahl der Schritte einer Handlungsanweisung.
John Swellers Cognitive Load Theory (1988) unterscheidet die Last, die zur Aufgabe gehört, von der Last, die ihre Darstellung verursacht. Paul Chandler und Sweller (1991) zeigten den Split-Attention-Effekt: Wenn Leser eine Abbildung und einen getrennten Text im Kopf zusammenführen müssen, leidet das Lernen.
Für die Dokumentation heißt das: Entscheidend ist nicht, wie viele Schritte eine Handlungsanweisung hat, sondern wie viel jeder Schritt den Leser gleichzeitig im Kopf behalten lässt.
- Sieben plus oder minus zwei ist keine Regel für Schritte.
- Kurze Schritte sind nicht automatisch leichte Schritte.
- Das Arbeitsgedächtnis ist kein Ablageort für das Handbuch.
Was der Leser im Kopf behalten muss, sollte die Dokumentation auf der Seite festhalten.
Dokumentationsentscheidung
- Schrittgröße
- Chunking
- Werte am Schritt
- Verbindung von Bild und Text
- geteilte Aufmerksamkeit
7. Erinnern
Kernfrage: Woran muss sich der Leser später erinnern, und was kann auf der Seite bleiben?
Erinnern heißt, dass das, was später gewusst werden muss, entweder sicher gelernt oder in dem Moment verfügbar ist, in dem es gebraucht wird.
Technische Redakteure müssen fragen:
- Welche Information muss der Leser auswendig wissen?
- Welche Information muss er nur wiedererkennen, wenn er sie sieht?
- An welche Absicht muss sich der Leser zu einem späteren Zeitpunkt erinnern?
- Wo wird eine Unterbrechung eintreten, und wie findet der Leser wieder hinein?
- Lässt sich eine Erinnerung dort platzieren, wo die Handlung stattfindet?
- Welche Information gehört eher in die Schulung als in das Handbuch?
Wiedererkennen ist leichter als Abrufen: Menschen erkennen Information, die sie sehen, weit zuverlässiger, als sie sie aus dem Gedächtnis hervorholen. Deshalb sind Bedienoberflächen und Arbeitshilfen, die Optionen zeigen, Anweisungen überlegen, die man sich merken muss.
Das prospektive Gedächtnis – daran zu denken, später etwas zu tun – ist besonders anfällig. Gilles Einstein und Mark McDaniel (1990) untersuchten, wie solche Absichten durch Hinweisreize ausgelöst werden. Erik Altmann und Gregory Trafton (2002) beschrieben die Kosten des Wiedereinstiegs in eine Aufgabe nach einer Unterbrechung, die Resumption Lag.
Für die Dokumentation heißt das: Wichtige Absichten brauchen im richtigen Moment einen Hinweisreiz, und Handlungsanweisungen, die oft unterbrochen werden, brauchen klare Stellen, an denen der Leser sie wieder aufnehmen kann.
- Einmal gelesen ist nicht erinnert.
- Schulung ersetzt keine Information am Ort der Nutzung.
- Eine Unterbrechung ist ein vorhersehbarer Teil der Aufgabe.
Was der Leser nicht vergessen darf, sollte die Dokumentation nicht dem Gedächtnis überlassen.
Dokumentationsentscheidung
- Arbeitshilfen
- Erinnerungen am Ort der Nutzung
- Wiedererkennen statt Abrufen
- Wiedereinstiegspunkte
- Schulungsinhalte
8. Entscheiden
Kernfrage: Kann der Leser mit dieser Information die richtige Entscheidung treffen?
Entscheiden heißt, dass Leser auf Grundlage der gegebenen Information die richtige Handlung wählen – einschließlich der Entscheidung, nicht zu handeln.
Technische Redakteure müssen fragen:
- Vor welcher Entscheidung steht der Leser an dieser Stelle?
- Werden die Kriterien der Entscheidung genannt, oder muss der Leser sie erraten?
- Sind die Folgen jeder Möglichkeit sichtbar?
- Weiß der Leser, wann er aufhören und jemanden rufen muss?
- Lässt die Formulierung ein Risiko kleiner oder größer erscheinen, als es ist?
- Welche Abkürzung wird ein Leser unter Druck nehmen wollen?
Menschen entscheiden nicht wie Rechenmaschinen. Amos Tversky und Daniel Kahneman (1974) beschrieben Heuristiken und Verzerrungen – Faustregeln, die meist effizient und manchmal systematisch falsch sind. Herbert Simon (1956) beschrieb Satisficing: Menschen wählen die erste Möglichkeit, die gut genug erscheint.
Mica Endsley (1995) beschrieb Situationsbewusstsein in drei Stufen: die Elemente einer Situation wahrnehmen, ihre Bedeutung verstehen und vorhersehen, was als Nächstes geschieht. Paul Slovics Forschung zur Risikowahrnehmung (1987) zeigt, dass Menschen Risiken nach Vertrautheit und Kontrolle beurteilen, nicht nur nach Wahrscheinlichkeit.
Für die Dokumentation heißt das: Entscheidungskriterien, Folgen und Abbruchkriterien müssen ausdrücklich sein. Ein kognitives Argument ersetzt nie die Risikobeurteilung; es hilft nur, ihre Ergebnisse so zu vermitteln, dass sie genutzt werden können.
- Information ist keine Entscheidung.
- Ein vertrautes Risiko ist kein kleines Risiko.
- Zu wissen, wann man aufhört, ist Teil der Aufgabe.
Dokumentation, die die Entscheidungskriterien verschweigt, überlässt die Entscheidung dem Zufall.
Dokumentationsentscheidung
- Entscheidungskriterien
- Bedingungen
- Folgen
- Risikokommunikation
- Abbruchkriterien
9. Handeln
Kernfrage: Kann der Leser die Information in die richtige Handlung umsetzen?
Handeln heißt, dass Leser die gemeinte Handlung richtig, in der richtigen Reihenfolge und mit dem richtigen Ergebnis ausführen.
Technische Redakteure müssen fragen:
- Ist die Handlung so formuliert, dass der Leser sie direkt ausführen kann?
- Sagt jeder Schritt, was der Leser tut und was er beobachten soll?
- Ist das Verhalten an dieser Stelle fertigkeits-, regel- oder wissensbasiert?
- Wo wird der Leser wahrscheinlich aus Gewohnheit handeln, statt zu lesen?
- Welcher kritische Schritt würde von einer Checkliste oder Bestätigung profitieren?
- Weiß der Leser, wann die Aufgabe abgeschlossen ist?
Jens Rasmussen (1983) unterschied fertigkeitsbasiertes, regelbasiertes und wissensbasiertes Verhalten. Eingeübte Routinehandlungen laufen mit wenig bewusster Steuerung ab; Regeln werden auf vertraute Situationen angewendet; wissensbasiertes Denken braucht es für neue Probleme, und es ist langsam und fehleranfällig. Dokumentation spricht jede Ebene anders an.
Die Forschung zu Checklisten in der Luftfahrt, etwa von Asaf Degani und Earl Wiener (1990), zeigt, dass Checklisten kritische Abläufe unterstützen, wenn sie kurz, geordnet und für die Situation gestaltet sind, in der sie verwendet werden.
Für die Dokumentation heißt das: Eine Handlungsanweisung muss zu der Verhaltensebene passen, auf der die Aufgabe ausgeführt wird, und sie muss dem Leser das Ergebnis jeder Handlung zeigen.
- Einen Schritt zu lesen heißt nicht, ihn auszuführen.
- Eine Funktionsbeschreibung ist keine Anweisung.
- Eine Checkliste ist kein gekürztes Handbuch.
Anweisungen gelingen erst, wenn der Leser nach ihnen handeln kann.
Dokumentationsentscheidung
- Handlungsanweisung
- Handlungsverben
- eine Handlung pro Schritt
- Rückmeldung und Ergebnis
- Checkliste
- Arbeitshilfe
10. Wiederherstellen
Kernfrage: Kann der Leser einen Fehler erkennen und in einen sicheren Zustand zurückkehren?
Wiederherstellen heißt, dass Leser bemerken, dass etwas schiefgegangen ist, verstehen, welche Art von Problem es ist, und in einen sicheren, funktionierenden Zustand zurückkehren.
Technische Redakteure müssen fragen:
- Woran bemerkt der Leser, dass etwas schiefgegangen ist?
- Beginnt die Fehlersuche bei dem Symptom, das der Leser tatsächlich sieht?
- Unterscheidet sie eine vergessene Handlung von einem falschen Plan?
- Welcher Schritt zur Behebung ist unter Zeitdruck sicher?
- Wann muss der Leser aufhören und eskalieren?
- Was muss vor einem Wiederanlauf geprüft werden?
- Welche unsichere Behelfslösung ist nach einer Störung vorhersehbar?
James Reason (1990) unterschied Patzer und Aussetzer – die richtige Absicht, falsch ausgeführt oder vergessen – von Fehlern, bei denen schon der Plan falsch ist. Donald Norman (1981) hatte Patzer bereits zuvor eingeteilt. Die Arten brauchen unterschiedliche Hilfe: Patzer brauchen Gestaltung und Rückmeldung, Aussetzer brauchen Hinweisreize, Fehler brauchen ein besseres Modell und bessere Entscheidungsinformation.
Fehler sind in technischer Arbeit keine Ausnahme. Sie sind vorhersehbar. Die Behebung ist der Teil der Aufgabe, in dem der Stress am höchsten und die Geduld am geringsten ist und in dem die Kluft der Bewertung darüber entscheidet, ob der Leser versteht, was ihm das System sagt.
Für die Dokumentation heißt das: Information zur Fehlersuche und Behebung muss für einen Leser unter Stress geschrieben sein. Sie unterstützt die in der Risikobeurteilung festgelegten Schutzmaßnahmen; sie ersetzt sie nicht.
- Ein Fehler ist kein Versagen des Lesers.
- Ein Patzer ist kein Irrtum im Plan.
- Eine Fehlermeldung ist keine Erklärung.
Dokumentation beweist ihren Wert, wenn etwas schiefgeht.
Dokumentationsentscheidung
- Fehlersuche
- Symptome und Ursachen
- Fehlermeldungen
- Schritte zur Behebung
- Eskalation
- Bedingungen für den Wiederanlauf
Warum die Seite der Leser wichtig ist
Die Seite der Leser ist wichtig, weil Dokumentation dort beurteilt wird, wo sie genutzt wird, nicht dort, wo sie geschrieben wird.
- Wenn die Information nicht bemerkt wird, schützt sie nicht.
- Wenn sie nicht gefunden wird, hilft sie nicht.
- Wenn der Leser nicht weiß, wo er ist, wendet er die falsche Information an.
- Wenn das Modell falsch ist, führen richtige Schritte zu falschen Handlungen.
- Wenn ein Schritt das Arbeitsgedächtnis überfordert, lässt der Leser einen Teil davon fallen.
- Wenn die Entscheidungskriterien fehlen, rät der Leser.
- Wenn die Behebung nicht dokumentiert ist, improvisiert der Leser.
Technisches Schreiben ist nicht fertig, wenn der Text richtig ist. Es ist fertig, wenn die Information von den Menschen, die sie brauchen, bemerkt, gefunden, verstanden, behalten, erinnert und in Handlung umgesetzt werden kann.
Vom Kopf der Leser zur Dokumentationslogik
Vom Kopf der Leser zur Dokumentationslogik heißt, das, was über Kognition bekannt ist, in Dokumentationsentscheidungen zu verwandeln.
Die Technische Redakteurin beginnt nicht mit einer Stilregel. Sie beginnt mit Unterscheidungen auf der Seite der Leser:
- Bemerkt oder nur sichtbar?
- Gesucht oder gelesen?
- Bekannter Kontext oder vorausgesetzter Kontext?
- Ausgesprochene Bedeutung oder erschlossene Bedeutung?
- Richtiges Modell oder übertragenes Modell?
- Auf der Seite gehalten oder im Kopf gehalten?
- Wiedererkannt oder abgerufen?
- Entscheidungskriterium oder Hintergrundinformation?
- Fertigkeit, Regel oder Wissen?
- Patzer, Aussetzer oder Fehler im Plan?
- Routinesituation oder Situation unter Stress?
Diese Unterscheidungen formen die Dokumentation von der Seite der Leser her. Sie ergänzen die Unterscheidungen des Stacks der Redakteure; sie ersetzen sie nicht.
Warum Testen wichtiger ist als Annehmen
Redakteure können ihre eigene Dokumentation nicht mit den Augen der Leser sehen. Sie wissen zu viel. Jede Annahme darüber, was der Leser bemerkt, versteht oder tut, ist eine Hypothese.
Die Kognitionspsychologie bietet mehr als Befunde. Sie bietet auch Methoden, solche Hypothesen zu prüfen. Beim lauten Denken sagen Leser, was sie denken, während sie die Dokumentation nutzen. Beim Cognitive Walkthrough gehen Prüfende eine Aufgabe Schritt für Schritt durch und fragen bei jedem Schritt, ob der Benutzer wissen wird, was zu tun ist, und ob er den Erfolg erkennt. Verständnistests und Tests zum Verständnis von Symbolen prüfen, ob Leser die gemeinte Bedeutung erreichen.
Keine dieser Methoden braucht ein Labor. Einige Leser aus der Zielgruppe, eine realistische Aufgabe und genaues Beobachten zeigen mehr als viele Runden interner Prüfung.
Eine Technische Redakteurin, die testet, statt anzunehmen, kann:
- sehen, wo Leser anhalten, suchen oder falsch lesen
- ein Formulierungsproblem von einem Strukturproblem unterscheiden
- die Schlussfolgerungen finden, die Leser nicht ziehen können
- Warnungen entdecken, die nicht bemerkt werden
- Dokumentationsentscheidungen auf Beobachtung statt auf Meinung stützen
Den Kopf der Leser kann man nicht aus dem Text ablesen. Man muss ihn beobachten.
Das Grundprinzip
Das Grundprinzip ist einfach: Dokumentation findet im Kopf des Lesers statt, nicht auf dem Papier.
Der „Writer's Stack“ ( „Stack“ des Autors und/oder Redakteurs)schafft die Struktur vor dem Text. Der Reader's Stack ( „Stack“ des Lesers) prüft, ob diese Struktur den Leser erreicht: ob sie wahrgenommen, gefunden, verstanden, verinnerlicht, im Gedächtnis behalten und in die richtige Handlung umgesetzt wird.
Kognitive Grundsätze dienen als Grundlage für Entscheidungen zur Dokumentation. Sie ersetzen jedoch keinesfalls die Risikobewertung des Herstellers, die gesetzlich vorgeschriebenen Sicherheitshinweise oder die Überprüfung durch die für die Dokumentation verantwortlichen Personen.
Komplexität reduzieren – Klarheit schaffen
Im Kontext erklärt
Context Cards erklären den allgemeinen, überprüfbaren Hintergrund einiger Fragen, die dieser Blueprint aufwirft. Sie stammen von knowledge.aitechdoc.world und sind nicht Teil des Blueprints.
- Kognitionspsychologie in der technischen Kommunikation: Theorie, Anwendung und die Brücken dazwischenWorin unterscheidet sich Kognitionspsychologie als Theorie von ihrer Anwendung in der Dokumentation, und wie hängen beide zusammen?Karte lesen
- Arbeitsgedächtnis und Handlungsschritte: warum „sieben plus minus zwei“ die falsche Regel istRechtfertigt die Forschung zum Arbeitsgedächtnis eine feste Höchstzahl von Schritten in einer Handlungsanweisung, etwa sieben plus minus zwei?Karte lesen
- Mentale Modelle und Konzeptinformation: warum Leser wissen müssen, wie etwas funktioniert, bevor sie handelnWie stützt die Forschung zu mentalen Modellen, dass Konzeptinformation in der Technischen Dokumentation vor der Handlungsinformation steht?Karte lesen
- Aufmerksamkeit und die Platzierung von Warnhinweisen: von selektiver Aufmerksamkeit und Gewöhnung zum richtigen OrtWas sagt die Forschung zu Aufmerksamkeit und Warnhinweisen darüber, wo und wie Warnhinweise in Anleitungen stehen sollten?Karte lesen
- Kognitive Belastung und geteilte Aufmerksamkeit: warum Abbildung, Beschriftung und Text zusammengehörenWas sagt die Cognitive Load Theory über die Verbindung von Abbildung und Text in Anleitungen, und was folgt daraus für die Technische Dokumentation?Karte lesen
- Fehlerarten und Fehlersuche: von Patzern, Aussetzern und Irrtümern zu Informationen für die BehebungWie helfen die Fehlerarten von James Reason und Jens Rasmussens fertigkeits-, regel- und wissensbasiertes Verhalten bei der Gestaltung von Fehlersuche- und Behebungsinformationen?Karte lesen
- Wohin eine Warnung gehört: Sicherheitskapitel oder vor die HandlungGehört eine Warnung ins Sicherheitskapitel oder direkt vor den Schritt, den sie betrifft?Karte lesen
- Wie sich First Principles Thinking entwickelt hat: eine Abwandlung vieler AbwandlungenWoher kommt First Principles Thinking, und wie hat es sich auf dem Weg ins technische Schreiben verändert?Karte lesen
Zitiervorschlag
Saina Veigel (2026): Kognitionspsychologie für die Technische Kommunikation. Blueprint, Ausgabe 2. knowledge.aitechdoc.world. https://knowledge.aitechdoc.world/de/blueprints/cognitive-psychology-for-technical-communication
Ausgabe und Änderungen
Ausgabe 2 · Geprüft
Korrekturen (etwas war falsch) und Ergänzungen (etwas fehlte) seit der ersten Ausgabe.
Seit der ersten Ausgabe gab es keine Korrekturen oder Ergänzungen.
Zu diesem Blueprint
Dieser Blueprint ist ein Denkmodell, keine Norm und keine von irgendjemandem zertifizierte Methode. Wird eine Norm, ein Gesetz oder eine etablierte Methode genannt, heißt das nicht, dass eine Dokumentation ihr entspricht.
Er ersetzt weder die Risikobeurteilung des Herstellers noch die Betriebsanleitung eines Produkts noch die Prüfung der Dokumentation durch die dafür Verantwortlichen.
Copyright © 2026 Saina Veigel. Alle Rechte vorbehalten. Urheberrechtshinweis