Blueprint · Methodischer Feinschliff
Die Rollengrammatik technischer Information: Lesen, Schreiben und Zusammenstellen
Vier Achsen, die sagen, wer was mit einer technischen Information tut – für Menschen und Systeme gleichermaßen
Eine Rolle ist, was jemand mit der Information tut – nicht, wer er ist.
- Von
- Von Saina Veigel · Communications Specialist · Senior Technical Writer
- Ausgabe
- 1
- Zuerst veröffentlicht
- Geprüft
Die früheren Blueprints auf dieser Website sprechen vom Schreibenden, von der Maschine und vom Lesenden – im Singular. Das ist eine bewusste Vereinfachung. Sie macht ein erstes Modell leicht greifbar: Jemand baut die Struktur, etwas nutzt sie, jemand handelt danach. Für einen ersten Blick auf ein Dokumentationsprojekt genügt das, und es zeigt schnell, wer ein Interesse an der Quelle hat.
In der Praxis ist jede der drei Positionen eine Familie. Viele Menschen schreiben: die Technische Redakteurin, der Ingenieur, der die Werte liefert, die Übersetzerin, der Prüfer und die Person, die freigibt. Auch viele Systeme schreiben. Viele Menschen lesen, und sie unterscheiden sich: Eine für eine Aufgabe unterwiesene Bedienerin, ein an der Maschine geschulter Bediener und eine Elektrofachkraft, die den Schaltschrank öffnen darf, brauchen von derselben Seite unterschiedliche Informationen. Und zwischen ihnen stehen Systeme, die die Information weitergeben, zu etwas Neuem zusammenstellen – und sie manchmal zurückschreiben.
Dieser Blueprint schärft die Vereinfachung nach, ohne sie zu ersetzen. Er beschreibt eine Rollengrammatik: vier Achsen, die für eine Information sagen, was mit ihr getan wird, wer es tut, was diese Person oder dieses System kann und darf und in welcher Situation. Die Achsen gelten für Menschen und Systeme gleichermaßen. Die früheren Blueprints bleiben gültig; dieser sagt, wo ihr Singular zum Plural werden muss.
Er ist für Technische Redakteurinnen und Redakteure, technische Projektleitungen und Entwickler von Dokumentationssystemen geschrieben, die entscheiden müssen, an wen sich ein Dokument richtet, wer darin was ändern darf und von welchem System oder welcher Person ein Wert stammt. Die Beispiele spielen am fiktiven Referenzsystem DS-3, der konfigurierbaren Montage- und Prüfzelle aus der Prüfstrategie „Wer entscheidet, welcher Wert gilt“.
Warum der Singular einen Plural braucht
Ein Modell im Singular ist eine Linse. Es stellt eine Frage scharf – was muss der Schreibende durchdenken, was muss im Kopf des Lesenden geschehen, was braucht die Maschine – und lässt den Rest bewusst aus dem Bild. Die früheren Blueprints nutzen es so, und sie gewinnen dadurch an Klarheit.
Zum Problem wird der Singular erst, wenn eine Entscheidung von dem Unterschied abhängt, den er auslässt. Ob ein Warnhinweis genügt, hängt davon ab, wer ihn liest. Ob eine Änderung freigegeben ist, hängt davon ab, wer freigeben darf. Ob einer Antwort zu trauen ist, hängt davon ab, ob die Funktion, die sie gegeben hat, die Quelle gelesen oder aus mehreren Quellen einen neuen Text zusammengestellt hat. An diesen Stellen verdeckt der Singular genau das, was die Dokumentation entscheiden muss.
Die Rollengrammatik fügt den früheren Modellen keine neuen Akteure hinzu. Sie fügt die Achsen hinzu, entlang derer sich die vorhandenen unterscheiden – damit sich ein Singular dort zu seinem Plural öffnen lässt, wo eine Entscheidung es braucht, und dort wieder schließen, wo nicht.
Hinter „dem Schreibenden“, „der Maschine“ und „dem Lesenden“ eines einzigen Warnhinweises stehen meist:
- eine Technische Redakteurin und ein Ingenieur, der die Werte liefert
- ein Prüfer und eine Person, die freigibt
- eine Übersetzerin und ein Translation Memory
- eine KI-Funktion, die eine erste Fassung entworfen hat
- ein Content-System, das die Anleitung zusammensetzt
- eine Antwortfunktion, die daraus Antworten zusammenstellt
- eine unterwiesene Bedienerin, ein geschulter Bediener und eine Elektrofachkraft
- ein Service-Agent, der nach einer Reparatur einen Status setzt
Jede und jeder davon tut mit demselben Satz etwas anderes.
Die Dokumentation muss nicht jedes Mal alle beschreiben. Sie muss wissen, von welchem Unterschied eine Entscheidung abhängt – und genau diesen benennen.
Das Kernproblem
Werden Rollen im Singular benannt, verschwinden die Unterschiede, von denen Entscheidungen abhängen.
- Geschrieben wird für „den Benutzer“, und die unterwiesene Bedienerin bekommt den Text, der für die Elektrofachkraft gedacht war.
- Eine Qualifikation wird für eine Befugnis gehalten: Wer eine Aufgabe kann, darf sie angeblich auch.
- Eine Stellenbezeichnung wird für eine Rolle gehalten: „Der Ingenieur“ liefert einen Wert und gibt ihn frei, und niemand merkt, dass das Vier-Augen-Prinzip verschwunden ist.
- Eine Antwortfunktion wird Lesender genannt, obwohl sie einen Text schreibt, den niemand freigegeben hat.
- „Die Maschine“ wird als ein Akteur behandelt, obwohl ihre Teile auf verschiedene Weise lesen, zusammenstellen und schreiben und verschiedene Eigentümer haben.
- Eine Situation wird für eine Person gehalten: Der Neuling wird für die erste Nutzung eingeplant, der Experte für die Wartung – und der Experte im Notfall wird vergessen.
- Ein Agent, der lesen sollte, schreibt zurück, und niemand hatte festgehalten, dass er das darf.
- Eine Übersetzung wird als Kopie behandelt, obwohl die Übersetzerin einen neuen Text in einer anderen Sprache schreibt.
Eine Rolle im Singular lässt sich nicht prüfen – und eine Rolle, die sich nicht prüfen lässt, spielt, wer gerade da ist.
Blueprints
Die vier Achsen und ihre Teile
Fünf Tätigkeitsfamilien, dann Akteur, Qualifikation, Befugnis und Situation – und der Rollensatz, der sie verbindet
Die ersten fünf Teile sind die Tätigkeitsfamilien: was mit der Information getan wird. Die nächsten vier sind die Achsen, die sagen, wer es tut und unter welchen Bedingungen. Der zehnte Teil ist der Rollensatz, der sie verbindet. Jeder Teil beantwortet eine Prüffrage und hinterlässt eine Dokumentationsentscheidung.
Seitlich scrollen, um alle Spalten zu sehen.
| Teil | Prüffrage | Dokumentationsentscheidung |
|---|---|---|
| Schreiben | Wer erzeugt diese Information oder trägt zu ihr bei? | Die Autorinnen und Beitragenden · die Quelle jedes Werts · die Kennzeichnung entworfener Texte |
| Entscheiden | Wer darf entscheiden, dass diese Fassung gilt? | Prüf- und Freigaberollen · die gültige Fassung · die Trennung von Schreiben und Freigeben |
| Zusammenstellen | Was wird neu, wenn diese Information weitergegeben, kombiniert oder beantwortet wird? | Die zusammenstellenden Rollen · was jede von ihnen ändern darf · der Nachweis, was woraus zusammengestellt wurde |
| Nutzen | Wer handelt nach dieser Information, und was braucht er, um sicher zu handeln? | Die Zielgruppen nach Qualifikation · die Aufgaben je Zielgruppe · wo eine Aufgabe endet |
| Zurückschreiben | Wer handelt nach dieser Information und ändert dabei einen Wert? | Schreibbefugnisse · das Gate für jedes Zurückschreiben · der Nachweis jeder Änderung |
| Der Akteur | Spielt ein Mensch, ein regelbasiertes System, eine KI-Funktion oder ein KI-Agent diese Rolle? | Der Akteur je Rolle · die Prüfung, die ein wahrscheinliches Ergebnis braucht · was ein Agent allein tun darf |
| Qualifikation | Was kann diese Person, und wie ist es nachgewiesen? | Die Qualifikationsstufen, die ein Dokument verwendet · die Aufgaben je Stufe · die Begriffe aus den anwendbaren Normen und Gesetzen |
| Befugnis | Was darf diese Rolle hier tun – an diesem Produkt, heute, in dieser Betriebsart? | Befugnisse je Rolle · Zugriffsebenen und Betriebsarten · die Trennung von Aufgaben |
| Situation | In welcher Situation trifft diese Rolle auf die Information? | Die Nutzungssituationen je Zielgruppe · die Information, die jede Situation braucht · was nie von der Situation abhängt |
| Der Rollensatz | Lässt sich die Rolle als ein Satz mit allen vier Achsen schreiben? | Ein Rollensatz je Entscheidung, die von einer Rolle abhängt · die Lücken, die er zeigt · wo der Singular genügt |
Die Teile sind keine Abfolge, die jede Information durchläuft, und kein Organigramm. Sie sind eine Grammatik: eine Art, für eine Information zu sagen, wer was mit ihr tut.
Eine Rolle ist, was jemand mit der Information tut – nicht, wer er ist.
Ein Warnhinweis, viele Rollen · Referenz
Die Rollentabelle
Der Warnhinweis an der Türverriegelung der fiktiven Zelle DS-3, gesehen durch alle vier Achsen
Die Tabelle folgt einer Information – dem Warnhinweis, dass die Tür der Prüfstation erst geöffnet werden darf, wenn die Zelle steht und die Verriegelung freigegeben hat – durch die Rollen, die sie durchläuft. Jede Zeile nennt die Tätigkeit, den Akteur, Qualifikation und Befugnis, die Situation, was die Rolle braucht, und die Dokumentationsentscheidung. Das Beispiel ist fiktiv.
Seitlich scrollen, um alle Spalten zu sehen.
| Rolle | Tätigkeitsfamilie | Akteur | Qualifikation | Befugnis | Situation | Was die Rolle braucht | Dokumentationsentscheidung |
|---|---|---|---|---|---|---|---|
| Technische Redakteurin | Schreiben | Mensch | Ausgebildete Technische Redakteurin | Darf das Topic schreiben und ändern; darf es nicht freigeben | Änderung nach einer Konstruktionsrevision | Die freigegebene Risikobeurteilung und die Konstruktionsrevision, auf der der Warnhinweis beruht | Für jeden Wert im Warnhinweis die Quelle und die zugehörige Revision nennen |
| Konstrukteur | Schreiben (beitragen) | Mensch | Fachexperte für die Verriegelung | Entscheidet den technischen Wert in der Konstruktion; darf das Topic nicht bearbeiten | Änderung der Verriegelungskonstruktion | Eine Frage, die genau nennt, welchen Wert die Dokumentation braucht | Festhalten, welche Werte der Fachexperte geliefert hat und in welcher Revision |
| Entwurfsfunktion | Schreiben | KI-Funktion | — | Darf einen Entwurf vorschlagen; darf die Quelle nicht ändern | Erster Entwurf eines überarbeiteten Topics | Die freigegebene Quelle und die Regel, dass Sicherheitsinformationen nie gekürzt werden | KI-entworfenen Text kennzeichnen, bis ein Mensch ihn übernommen hat |
| Prüfer und freigebende Person | Entscheiden | Mensch (zwei Personen) | Redakteur für die Prüfung; verantwortliche Person für die Freigabe | Die freigebende Person darf freigeben; die Redakteurin darf ihren eigenen Text nicht freigeben | Freigabe einer neuen Revision | Die Änderungen gegenüber der letzten Revision und die Nachweise, auf denen sie beruhen | Prüfung und Freigabe trennen und beide festhalten |
| Übersetzerin | Zusammenstellen (übersetzen) | Mensch mit Translation Memory | Qualifizierte Fachübersetzerin | Darf den Zieltext schreiben; darf die Quelle nicht ändern | Übersetzung der freigegebenen Revision | Die freigegebene Quellrevision und die Terminologie | Nur freigegebene Revisionen übersetzen und festhalten, welche |
| Antwortfunktion | Zusammenstellen (beantworten) | KI-Funktion | — | Darf Antworten aus freigegebenen Einheiten zusammenstellen; darf Sicherheitsinformationen nicht kürzen | Eine Frage am Bedienpanel | Freigegebene Einheiten mit ihrer Gültigkeit und die Grenze dessen, was sie beantworten darf | Jede Antwort als neuen Text behandeln, der auf freigegebene Quellen verweist – nicht als Lesen |
| Bedienerin, unterwiesen | Nutzen | Mensch | Unterwiesene Person | Darf die Zelle stoppen und eine Störung quittieren; darf die Verriegelung nicht überbrücken | Routinebetrieb | Eine Handlung und einen Warnhinweis, in der Reihenfolge der Aufgabe | Die Aufgabe für die genannte Qualifikation schreiben und sagen, wo sie endet |
| Bediener, an der Zelle geschult | Nutzen | Mensch | Geschult für Einrichten und Formatwechsel | Darf die Tür öffnen, nachdem die Verriegelung freigegeben hat; darf Formatteile wechseln | Störung: ein Teil klemmt in der Station | Den sicheren Zustand, wie er erreicht wird und woran er zu erkennen ist | Der Störung eine eigene Aufgabe mit der Prüfung des sicheren Zustands geben |
| Elektrikerin | Nutzen | Mensch | Elektrofachkraft | Darf nach Lockout/Tagout im Schaltschrank arbeiten | Wartung der Verriegelung | Den Stromkreis, die Energiequellen und die Prüfung nach der Arbeit | Die Fachkraft mit dem Namen der Qualifikation ansprechen, nicht als „qualifiziertes Personal“ |
| Service-Agent | Zurückschreiben | KI-Agent | — | Darf einen Status vorschlagen; darf ihn erst nach Bestätigung durch einen Menschen setzen | Nach einer Reparatur | Die Regel, welche Werte er schreiben darf und wer bestätigt | Jedes Zurückschreiben mit Grundlage und Bestätigung festhalten |
Qualifikation und Befugnis stehen bewusst in getrennten Spalten. Dieselbe Person kann für eine Aufgabe qualifiziert und dennoch an dieser Zelle, heute, in dieser Betriebsart nicht befugt sein.
Ein Warnhinweis, zehn Rollen – und jede braucht etwas anderes von ihm.
Wo der Singular zum Plural wird
Der Abgleich mit den früheren Blueprints
Jeder frühere Blueprint mit seiner Vereinfachung, warum sie dort hilft, der Achse, die sie nachschärft, und der Karte, die den Schritt zeigt
Die früheren Blueprints bleiben gültig. Jeder von ihnen vereinfacht bewusst, weil seine Frage so klarer beantwortet wird. Die Tabelle nennt die Vereinfachung, warum sie hilft, welcher Teil der Rollengrammatik sie öffnet und die Kontextkarte der Reihe „Methodischer Feinschliff“, die den Schritt von vorher zu nachher zeigt.
Seitlich scrollen, um alle Spalten zu sehen.
| Blueprint | Was er vereinfacht | Warum es dort hilft | Was es nachschärft | Karte zum methodischen Feinschliff |
|---|---|---|---|---|
| Denkmodelle für Technische Redakteure | Eine Schreibende, die Komplexität strukturiert | Das Denken vor dem Schreiben ist die Arbeit einer Person | Schreiben · Entscheiden · Qualifikation | Eine Schreibende, viele Schreibende |
| Kognitionspsychologie für die Technische Kommunikation | Ein Lesender; Situation und Vorwissen in einer Zeile | Was in einem Kopf geschieht, wird für einen Kopf beschrieben | Nutzen · Qualifikation · Situation | Drei Bediener, ein Warnhinweis |
| KI-gestützte Informationssysteme für Technische Redakteure | Berufsgruppen als Perspektiven; ein Lesender, ein KI-Agent; die Maschine als ein Akteur | Das Raster zeigt schnell, wer ein Interesse an der Quelle hat | Der Akteur · Zusammenstellen · Zurückschreiben | Von Berufsgruppen zu Rollen · Die Maschine ist ein Netz |
| KI-Systeme und die Maschine: Ebenen und Grenzen | Ebenen nach Zuständigkeit, nicht nach dem, was mit der Information getan wird | Die Frage nach dem Umfang wird Ebene für Ebene beantwortet | Der Akteur · Zusammenstellen | Die Maschine ist ein Netz |
| Der Content-Lebenszyklus unter KI | Lesender und Nutzer als eins; die Antwortfunktion in der Stufe „Antworten“ | Die Stufen und ihre Gates bleiben im Blick | Zusammenstellen · Nutzen | Die Antwortfunktion stellt zusammen |
| Wer entscheidet, welcher Wert gilt | Drei Platzhalter als eine Linse auf alle, die an einem Wert beteiligt sind | Eine Prüfmethode lässt sich entwerfen, bevor ein einziges System benannt ist | Die fünf Tätigkeitsfamilien · Qualifikation · Befugnis | Von drei Lesern zu Prüfrollen |
| Das Kuh-Modell | Ein idealisierter Lesender als Probe des Texts | Die Prüffrage braucht einen Lesenden, den man sich vorstellt | Nutzen – nur wo mehrere Lesende gemeint sind | Keine – der Singular ist die Methode |
Die Blueprints im Intranet (der Nachweisraum, die MedTech-Nachweiskette) benennen bereits mehrere eigene Rollen; die MedTech-Nachweiskette führt den Prüfer als eigenen Lesenden.
Der Singular ist eine Linse. Die Rollengrammatik sagt, wann man sie wechselt.
Verwechslungen · Referenz
Wo die Achsen verwechselt werden
Jede Verwechslung mit den Achsen, die sie vermischt, einem Beispiel, was sie kostet und wie man die Achsen auseinanderhält
Die meisten Fehler mit Rollen sind keine fehlenden Rollen, sondern vermischte Achsen. Jede Zeile nennt eine Verwechslung, die Achsen, die sie vermischt, ein Beispiel an der fiktiven Zelle DS-3, was sie kostet und wie man die Achsen auseinanderhält.
Seitlich scrollen, um alle Spalten zu sehen.
| Verwechslung | Vermischte Achsen | Beispiel | Was es kostet | Auseinanderhalten durch |
|---|---|---|---|---|
| Qualifikation für Befugnis gehalten | Qualifikation · Befugnis | Eine Elektrofachkraft von einem anderen Standort öffnet den Schaltschrank von DS-3, ohne dort befugt zu sein | Die Kontrolle des Betreibers darüber, wer an der Zelle arbeitet | Die verlangte Befugnis in der Aufgabe neben der Qualifikation nennen |
| Situation für Qualifikation gehalten | Situation · Qualifikation | Die Aufgabe „Klemmendes Teil entfernen“ ist für „erfahrene Benutzer“ geschrieben, doch ein Teil klemmt in jeder Schicht | Die unterwiesene Bedienerin trifft auf eine Aufgabe, die für jemand anderen geschrieben ist | Jede Situation für jede Zielgruppe planen, die auf sie trifft |
| Stellenbezeichnung für Rolle gehalten | Tätigkeit · Akteur | „Der Ingenieur“ liefert den Wert der Verriegelung und gibt das Topic frei | Der zweite Blick, den die Freigabe geben sollte | Liefern und Freigeben als zwei Rollen benennen, auch wenn ein Team beide hält |
| Akteur für Tätigkeit gehalten | Der Akteur · Zusammenstellen | „Das ist KI, also liest sie die Anleitung“ | Die Antwort wird wie die Anleitung behandelt, obwohl niemand sie freigegeben hat | Zuerst die Tätigkeit benennen: Eine Antwortfunktion stellt zusammen |
| Die Maschine für einen Akteur gehalten | Der Akteur · Ebenen | „Die Maschine hat sich geirrt“ | Niemand kann sagen, welcher Teil zu korrigieren ist | Den Teil benennen – Index, Retrieval, Modell, Agent – und seinen Eigentümer |
| Lesender für Schreibenden gehalten | Nutzen · Zurückschreiben | Der Service-Agent setzt einen Teilestatus, den der nächste Export verbreitet | Ein Wert, den niemand freigegeben hat, wird zum aktuellen | Jeder Rolle, die zurückschreibt, einen Umfang, ein Gate und einen Nachweis geben |
| Übersetzung für Kopie gehalten | Zusammenstellen · Schreiben | Die Übersetzung der Revision B bleibt bestehen, nachdem Revision C freigegeben wurde | Eine Sprachfassung mit einem alten Warnhinweis | Nur freigegebene Revisionen übersetzen und festhalten, welche |
Die Spalte „Auseinanderhalten durch“ nennt Dokumentationsentscheidungen, keine organisatorischen Regeln. Wer qualifiziert und wer befugt ist, entscheiden Hersteller und Betreiber.
Zwei Achsen, die auseinandergehalten werden, lassen sich einzeln prüfen.
Die Teile der Rollengrammatik
Jeder Eintrag erklärt einen Teil: seine Prüffrage, was er abdeckt, wo er endet und was die Dokumentation über ihn entscheiden muss. Die ersten fünf sind die Tätigkeitsfamilien, die nächsten vier die Achsen, der letzte ist der Rollensatz.
- Schreiben
- Entscheiden
- Zusammenstellen
- Nutzen
- Zurückschreiben
- Der Akteur
- Qualifikation
- Befugnis
- Situation
- Der Rollensatz
1. Schreiben
Kernfrage: Wer erzeugt diese Information oder trägt zu ihr bei?
Schreiben erzeugt eine Information oder trägt zu ihr bei: die Technische Redakteurin, die das Topic schreibt, der Ingenieur, der den Wert liefert, das System, das eine Parameterliste erzeugt, die Funktion, die eine erste Fassung entwirft.
Fragen in dieser Familie:
- Wer hat diesen Text geschrieben, und wer hat die Werte darin geliefert?
- Welche Teile hat eine Funktion entworfen und ein Mensch übernommen?
- Wen müsste man fragen, wenn sich ein Wert als falsch herausstellt?
Der Schreibende der früheren Blueprints ist die Technische Redakteurin, die Komplexität strukturiert, bevor sie schreibt. In der Praxis hat ein Text mehrere Schreibende. Der Fachexperte trägt Wissen bei, das die Redakteurin zu einer nutzbaren Einheit macht; ein Engineering-System trägt Werte bei; eine Entwurfsfunktion trägt einen Vorschlag bei. Jede und jeder davon schreibt, und jede und jeder ist eine eigene Fehlerquelle.
Für die Dokumentation ist Schreiben die Familie, an die sich Fragen richten. Ein Text, der nur eine Autorin nennt, schickt jede Frage zu einem Wert an die Person, die ihn formuliert hat – nicht an die, die ihn entschieden hat.
- Formuliert ist nicht geliefert.
- Ein Entwurf ist kein Text, solange ihn niemand übernimmt.
Jede Information hat mehr Schreibende, als ihre Autorenzeile zeigt.
Dokumentationsentscheidung
- Die Autorinnen und Beitragenden
- die Quelle jedes Werts
- die Kennzeichnung entworfener Texte
2. Entscheiden
Kernfrage: Wer darf entscheiden, dass diese Fassung gilt?
Entscheiden prüft eine Information, gibt sie frei oder führt sie als gültige Fassung: der Prüfer, die für die Freigabe verantwortliche Person, das System of Record, das die freigegebene Revision hält.
Fragen in dieser Familie:
- Wer prüft, und wer gibt frei – sind es zwei Personen?
- Welches System hält die gültige Fassung?
- Wie wird eine freigegebene Fassung für alle sichtbar, die danach kommen?
Schreiben und Entscheiden liegen oft bei derselben Person, und das ist für sich genommen nicht falsch. Zum Risiko wird es dort, wo eine Prüfung von einem zweiten Blick abhängt: bei Sicherheitsinformationen, bei Werten, auf denen eine Freigabe beruht, bei Änderungen, die viele Dokumente zugleich erreichen. Dort verlangt die Rollengrammatik, die beiden Rollen getrennt zu benennen – auch wenn ein kleines Team sie zwei Menschen geben muss, die sonst dieselbe Arbeit tun.
Auch Systeme entscheiden. Ein System of Record entscheidet, welche Revision für ein Objekt gilt; ein Content-System entscheidet, welche Topic-Fassung freigegeben ist. Die Prüfstrategie „Wer entscheidet, welcher Wert gilt“ beschreibt diese Rollen von der Quelle bis zur Antwort.
- Geprüft ist nicht freigegeben.
- Einen Wert zu halten heißt nicht, ihn zu entscheiden.
Eine Fassung, die niemand entschieden hat, entscheidet, wer zuletzt speichert.
Dokumentationsentscheidung
- Prüf- und Freigaberollen
- die gültige Fassung
- die Trennung von Schreiben und Freigeben
3. Zusammenstellen
Kernfrage: Was wird neu, wenn diese Information weitergegeben, kombiniert oder beantwortet wird?
Zusammenstellen nimmt vorhandene Information und macht etwas daraus: Eine Schnittstelle gibt sie weiter, ein Bericht leitet eine Kennzahl ab, ein Content-System setzt eine Anleitung zusammen, ein Paket bündelt sie, eine Übersetzerin schreibt sie in einer anderen Sprache, eine Antwortfunktion stellt eine Antwort zusammen.
Fragen in dieser Familie:
- Ist das Ergebnis eine Kopie, eine Ableitung, eine Zusammensetzung, eine Übersetzung oder ein neuer Text?
- Welche freigegebenen Quellen und Revisionen sind eingeflossen?
- Was darf die zusammenstellende Rolle ändern – Reihenfolge, Wortlaut, Umfang, nichts?
Zusammenstellen ist die Familie, die der Singular am stärksten verdeckt. In der Kette Schreibender – Maschine – Lesender sieht alles in der Mitte wie Transport aus. Doch eine Übersetzung ist ein neuer Text, eine zusammengesetzte Anleitung eine neue Kombination, und eine Antwort ein Text, den niemand freigegeben hat. Die Antwortfunktion liest und schreibt in einem Akt; sie stellt zusammen, sie liest nicht.
Für die Dokumentation entscheidet das Zusammenstellen darüber, was sich zurückverfolgen lässt. Ein Ergebnis, das festhält, woraus es zusammengestellt wurde, lässt sich korrigieren, wenn sich eine Quelle ändert. Eines, das das nicht tut, ist eine neue Quelle, die niemandem gehört.
- Eine Antwort ist kein Lesen.
- Eine Übersetzung ist keine Kopie.
Alles, was zusammengestellt wird, ist neu – und muss sagen, woraus es gemacht ist.
Dokumentationsentscheidung
- Die zusammenstellenden Rollen
- was jede von ihnen ändern darf
- der Nachweis, was woraus zusammengestellt wurde
4. Nutzen
Kernfrage: Wer handelt nach dieser Information, und was braucht er, um sicher zu handeln?
Nutzen liest eine Information, sieht sie an oder handelt danach: die Bedienerin am Panel, der Servicetechniker, die Elektrikerin, der Auditor, der die Dokumentation prüft, das System, das einen Wert übernimmt, ohne ihn zu ändern.
Fragen in dieser Familie:
- Wer liest das – mit welcher Qualifikation und in welcher Situation?
- Was muss jede und jeder davon tun, und was darf sie oder er nicht tun?
- Wer liest, um zu prüfen statt um zu handeln – ein Auditor, eine benannte Stelle, ein Einkäufer?
Der Lesende der früheren Blueprints ist der Mensch, in dessen Kopf Dokumentation wirken muss. Dieser Mensch ist selten einer. Dieselbe Seite liest jemand, der für eine Aufgabe unterwiesen wurde, jemand, der an der Maschine geschult ist, und eine Fachkraft, die mehr darf – und Menschen, die gar nicht am Produkt handeln, sondern prüfen, was die Dokumentation darüber sagt.
Die Zielgruppenanalyse, wie sie IEC/IEEE 82079-1 beschreibt, fragt bereits nach Fähigkeiten und Qualifikationen der Nutzer. Die Rollengrammatik hält diese Antwort in jeder Aufgabe sichtbar: an wen sich die Aufgabe richtet und wo sie für die anderen endet.
- Der Benutzer ist nicht eine Person.
- Lesen, um zu prüfen, ist nicht Lesen, um zu handeln.
Eine Aufgabe, die ihren Lesenden nicht nennt, ist für den geschrieben, der sie am wenigsten braucht.
Dokumentationsentscheidung
- Die Zielgruppen nach Qualifikation
- die Aufgaben je Zielgruppe
- wo eine Aufgabe endet
5. Zurückschreiben
Kernfrage: Wer handelt nach dieser Information und ändert dabei einen Wert?
Zurückschreiben ist Nutzen, das etwas ändert: ein Techniker, der nach einer Reparatur einen Status setzt, eine Funktion, die einen Wert korrigiert, ein Agent, der ein Ticket eröffnet oder einen Datensatz aktualisiert. Wer zurückschreibt, ist zum Schreibenden geworden.
Fragen in dieser Familie:
- Welche Werte darf diese Rolle ändern, und in welchem System?
- Welche Änderungen brauchen die Bestätigung eines Menschen, bevor sie wirksam werden?
- Was wird zu jeder Änderung festgehalten – der Wert davor, die Grundlage, die Befugnis?
Zurückschreiben schließt den Kreis zwischen Nutzenden und Schreibenden. Hier wird Feedback zu Daten, und hier wird ein Agent, der zum Lesen gebaut wurde, zur Quelle. Die Familie gibt es, damit dieser Moment gesehen wird: Ein Lesender, der schreibt, braucht, was jeder Schreibende braucht – einen Umfang, einen Eigentümer und ein Gate.
Für die Dokumentation ist eine Rolle, die zurückschreibt, eine Autorin, die niemand eingeladen hat. Ihre Änderung kann einen Wert verändern, auf dem ein Dokument beruht, und die nächste Synchronisation kopiert ihn, als wäre er freigegeben.
- Ein Lesender, der schreibt, ist ein Schreibender.
- Delegiert ist nicht befugt, solange es nicht festgehalten ist.
Jedes Zurückschreiben braucht ein Gate – sonst hat die Dokumentation eine Autorin, die niemand kennt.
Dokumentationsentscheidung
- Schreibbefugnisse
- das Gate für jedes Zurückschreiben
- der Nachweis jeder Änderung
6. Der Akteur
Kernfrage: Spielt ein Mensch, ein regelbasiertes System, eine KI-Funktion oder ein KI-Agent diese Rolle?
Die Akteursachse sagt, wer eine Rolle spielt: ein Mensch, ein deterministisches System, das festen Regeln folgt, eine KI-Funktion, die eine Aufgabe mit einem wahrscheinlichen Ergebnis erledigt, oder ein KI-Agent, der mehrere Schritte mit eigenen Werkzeugen ausführt.
Fragen auf dieser Achse:
- Ergibt dieselbe Eingabe hier immer dasselbe Ergebnis?
- Wer prüft ein Ergebnis, das nur wahrscheinlich ist?
- Welche Schritte geht ein Agent ohne einen Menschen – und welche nie?
Der Akteur ändert die Tätigkeit nicht. Eine Antwortfunktion stellt zusammen, eine Schnittstelle gibt weiter, eine Bedienerin nutzt – wer oder was auch immer es tut. Aber der Akteur ändert, was die Rolle braucht: Ein deterministisches System braucht eine einmalige Prüfung seiner Regeln, ein wahrscheinliches Ergebnis eine Prüfung jedes Mal, wenn es darauf ankommt, ein Agent Grenzen, bevor er startet.
„Die Maschine“ der früheren Blueprints ist nicht ein Akteur. Sie ist ein Netz von Akteuren, die verschiedene Rollen spielen: ein Index, der hält, ein Retrieval, das auswählt, ein Modell, das formuliert, ein Agent, der handelt. Der Blueprint „KI-Systeme und die Maschine: Ebenen und Grenzen“ beschreibt, wo das Unternehmen über sie entscheidet; die Akteursachse beschreibt, was jeder von ihnen mit der Information tut.
- Die Maschine ist nicht ein Akteur.
- Wahrscheinlich ist nicht falsch – aber es braucht eine Prüfung.
Wer den Akteur benennt, weiß, welche Prüfung folgt.
Dokumentationsentscheidung
- Der Akteur je Rolle
- die Prüfung, die ein wahrscheinliches Ergebnis braucht
- was ein Agent allein tun darf
7. Qualifikation
Kernfrage: Was kann diese Person, und wie ist es nachgewiesen?
Die Qualifikationsachse sagt, was eine Person aufgrund ihrer Ausbildung, Schulung und Erfahrung tun kann. Sie gilt für Lesende und Schreibende gleichermaßen.
Fragen auf dieser Achse:
- Welche Qualifikation verlangt diese Aufgabe, und welche Norm oder welches Gesetz benennt sie?
- Ist die Person für diese Aufgabe unterwiesen, an diesem Produkt geschult oder Fachkraft auf dem Gebiet?
- Welche Qualifikation braucht die Schreibende, um diese Einheit zu schreiben – und der Prüfer, um sie zu prüfen?
Für diese Achse gibt es etablierte Begriffe, und die Rollengrammatik verwendet sie, statt eigene zu erfinden. IEC 60050-826 unterscheidet für elektrische Gefährdungen den Laien, die (elektrotechnisch) unterwiesene Person und die Elektrofachkraft; der Arbeitsschutz kennt die qualifizierte und die befähigte Person; die MDR definiert den Laien. Zwischen Unterweisung und Fachkunde benennen viele Hersteller eine geschulte Stufe – an diesem Produkt geschult für Einrichten, Formatwechsel oder Störungsbehebung. Welche Stufen ein Dokument verwendet, wird einmal entschieden und dann in jeder Aufgabe angewendet.
Auch Schreibende haben Qualifikationen. Eine Einheit zur Sicherheitsparametrierung braucht eine Schreibende, die sie versteht, und einen Prüfer, der sie prüfen kann. Die Achse macht das sichtbar, ohne eine Rangfolge daraus zu machen: Ein Fachexperte ist kein besserer Schreibender, und eine Fachkraft keine bessere Lesende – sie brauchen Verschiedenes.
- Qualifiziert ist nicht befugt.
- Für eine Aufgabe unterwiesen ist nicht am Produkt geschult.
Eine Qualifikation, die ein Dokument benennt, lässt sich prüfen. „Qualifiziertes Personal“ nicht.
Dokumentationsentscheidung
- Die Qualifikationsstufen, die ein Dokument verwendet
- die Aufgaben je Stufe
- die Begriffe aus den anwendbaren Normen und Gesetzen
8. Befugnis
Kernfrage: Was darf diese Rolle hier tun – an diesem Produkt, heute, in dieser Betriebsart?
Die Befugnisachse sagt, was eine Rolle darf: die Erlaubnis durch den Betreiber des Produkts, die Zugriffsebene am Panel, die Betriebsart, das Freigaberecht in einem Content-System, das Schreibrecht eines Agenten.
Fragen auf dieser Achse:
- Wer erteilt diese Befugnis, und wo ist sie festgehalten?
- Hängt sie von der Betriebsart, der Zugriffsebene oder der Schicht ab?
- Welche Aufgaben müssen bei verschiedenen Rollen bleiben?
Befugnis und Qualifikation werden oft verwechselt, weil sie oft zusammengehen. Nicht immer. Eine Elektrofachkraft ist an dieser Maschine vielleicht nicht befugt; eine unterwiesene Bedienerin darf die Zelle vielleicht stoppen, aber nicht die Verriegelung überbrücken. Wer die Befugnis erteilt, entscheidet der Betreiber, nicht der Hersteller – die Dokumentation kann nur sagen, welche Befugnis eine Aufgabe verlangt.
Auch Systeme haben Befugnisse: Zugriffsrechte, Freigaberechte, Schreibrechte. Für KI-Funktionen und Agenten werden auf der Befugnisachse die Grenzen festgehalten – was ein Agent allein ändern darf, was er nur vorschlagen darf und was er nie anrühren darf.
- Können ist nicht Dürfen.
- Eine Zugriffsebene ist keine Qualifikation.
Eine Aufgabe, die ihre Befugnis nennt, sagt allen anderen, wo sie aufhören.
Dokumentationsentscheidung
- Befugnisse je Rolle
- Zugriffsebenen und Betriebsarten
- die Trennung von Aufgaben
9. Situation
Kernfrage: In welcher Situation trifft diese Rolle auf die Information?
Die Situationsachse sagt, wann eine Rolle auf die Information trifft: erste Nutzung, Routinebetrieb, eine selten ausgeführte Aufgabe, eine Störung, ein Notfall, die Wartung – und für Schreibende eine erste Fassung, eine Änderung oder eine Korrektur.
Fragen auf dieser Achse:
- In welchen Situationen trifft jede Zielgruppe auf die Information?
- Was ändert sich in einer Störung oder unter Zeitdruck – Aufmerksamkeit, Vorwissen, der wahrscheinliche Fehler?
- Welche Information muss in jeder Situation gleich bleiben?
Das Nutzungssituationsraster des Blueprints „Kognitionspsychologie für die Technische Kommunikation“ beschreibt, wie derselbe Lesende in der ersten Stunde, im Routinebetrieb und nach einer Störung unterschiedliche Informationen braucht. Die Rollengrammatik hält Situation und Qualifikation auf zwei Achsen, weil sie sich kreuzen: Eine Fachkraft steht im Notfall unter demselben Zeitdruck wie alle anderen, und auch eine unterwiesene Bedienerin trifft auf eine seltene Aufgabe.
Die Situation verringert nie, was erforderlich ist. Eine Kurzform für den Routinebetrieb lässt nie die Sicherheitsinformationen weg, die die Situation einer Störung oder eines Notfalls braucht.
- Eine Situation ist keine Person.
- Auch die Expertin hat Notfälle.
Die Qualifikation sagt, was jemand kann. Die Situation sagt, was er gerade kann.
Dokumentationsentscheidung
- Die Nutzungssituationen je Zielgruppe
- die Information, die jede Situation braucht
- was nie von der Situation abhängt
10. Der Rollensatz
Kernfrage: Lässt sich die Rolle als ein Satz mit allen vier Achsen schreiben?
Der Rollensatz verbindet die Achsen für eine Information: wer – mit welcher Qualifikation und Befugnis – was mit ihr tut, in welcher Situation.
Fragen mit dem Satz:
- Welcher Teil des Satzes lässt sich noch nicht füllen?
- Hängt die anstehende Entscheidung von diesem Teil ab?
- Wo genügt der Singular, weil nichts vom Unterschied abhängt?
Der Rollensatz ist die Probe der Grammatik. „Ein geschulter Bediener nutzt die Aufgabe ‚Klemmendes Teil entfernen‘ bei einer Störung und darf die Tür öffnen, nachdem die Verriegelung freigegeben hat.“ „Die Antwortfunktion stellt am Bedienpanel eine Antwort aus freigegebenen Einheiten zusammen und darf die Sicherheitsinformationen nicht kürzen.“ Bleibt ein Teil leer – niemand weiß, wer freigibt oder welche Qualifikation die Aufgabe verlangt –, hat die Dokumentation eine Entscheidung gefunden, die sie noch nicht getroffen hat.
Der Satz ist auch der Weg zurück zum Singular. Nicht jede Entscheidung hängt von allen vier Achsen ab. Wo nicht, genügen der Schreibende, die Maschine und der Lesende der früheren Blueprints, und die Rollengrammatik bleibt in der Schublade.
- Ein leerer Teil ist eine offene Entscheidung.
- Der Singular ist eine Wahl, kein Fehler.
Den Satz dort schreiben, wo eine Entscheidung von ihm abhängt – und nur dort.
Dokumentationsentscheidung
- Ein Rollensatz je Entscheidung, die von einer Rolle abhängt
- die Lücken, die er zeigt
- wo der Singular genügt
Warum das für die Dokumentation wichtig ist
Die Rollengrammatik macht aus „dem Schreibenden“, „der Maschine“ und „dem Lesenden“ Rollen, die sich prüfen lassen:
- jede Aufgabe nennt die Qualifikation und die Befugnis, die sie verlangt
- Zielgruppen werden einmal festgelegt und in jeder Aufgabe verwendet
- Schreiben, Prüfen und Freigeben werden getrennt benannt, wo eine Prüfung davon abhängt
- jeder Wert nennt die Person oder das System, die oder das ihn geliefert hat
- Übersetzungen und Antworten gelten als neue Texte, die auf freigegebene Quellen verweisen
- KI-Funktionen und Agenten werden nach dem benannt, was sie tun, nicht nach dem, was sie sind
- jede Rolle, die zurückschreibt, hat einen Umfang, einen Eigentümer und ein Gate
- Situation und Qualifikation werden auf zwei Achsen geplant, nicht auf einer
Eine Rolle, die benannt ist, lässt sich ansprechen, prüfen und korrigieren.
Unterscheidungen, die bleiben
Die Rollengrammatik beruht auf einigen Unterscheidungen, die die Alltagssprache verwischt. Jede hält zwei Achsen oder zwei Familien auseinander.
- Eine Rolle ist keine Stellenbezeichnung.
- Eine Rolle ist keine Person.
- Qualifiziert ist nicht befugt.
- Unterwiesen ist nicht geschult, und geschult ist nicht Fachkraft.
- Eine Situation ist keine Qualifikation.
- Formuliert ist nicht geliefert.
- Geprüft ist nicht freigegeben.
- Eine Antwort ist kein Lesen.
- Eine Übersetzung ist keine Kopie.
- Die Maschine ist nicht ein Akteur.
- Ein Lesender, der zurückschreibt, ist ein Schreibender.
- Der Singular ist eine Wahl, kein Fehler.
Jede Unterscheidung benennt zwei Rollen, die ein Singular zusammengelegt hätte.
Werkzeuge und KI
Werkzeuge halten schon vieles der Rollengrammatik: Benutzerrechte und Zugriffsebenen in Content-Systemen und am Panel, Freigabe-Workflows, Übersetzungsmanagement, Zielgruppen-Metadaten, rollenbasierte Zugriffskontrolle, Bestätigungsschritte für Agenten. Was sie selten halten, ist die Verbindung – dass diese Aufgabe sich an diese Qualifikation richtet, unter dieser Befugnis, in dieser Situation.
KI-Funktionen können helfen zu finden, wo ein Rollensatz unvollständig ist: Aufgaben ohne genannte Zielgruppe, Warnhinweise ohne Qualifikation, Schreibrechte ohne Gate. Die Rollen entscheiden können sie nicht. Wer qualifiziert ist, wer befugt ist und welche Situationen ein Produkt erzeugt, entscheiden der Hersteller, der Betreiber und die für die Dokumentation verantwortlichen Menschen.
Ein Werkzeug unterstützt die Rollengrammatik, wenn es:
- mit jeder Aufgabe die Zielgruppe und die verlangte Qualifikation speichert
- die Befugnis, die eine Aufgabe verlangt, von der Qualifikation getrennt hält
- für jede Einheit festhält, wer geschrieben, wer geliefert, wer geprüft und wer freigegeben hat
- von einer Funktion entworfenen Text kennzeichnet, bis ein Mensch ihn übernimmt
- zeigt, aus welchen freigegebenen Quellen eine Antwort oder Übersetzung zusammengestellt wurde
- jeder Rolle, die zurückschreibt, einen Umfang, einen Bestätigungsschritt und einen Nachweis gibt
Werkzeuge halten die Rechte. Die Rollengrammatik sagt, von welchem Recht eine Entscheidung abhängt.
Das Kernprinzip
Das Kernprinzip ist kurz: Eine Rolle ist, was jemand mit der Information tut – nicht, wer er ist.
Die früheren Blueprints sprechen vom Schreibenden, von der Maschine und vom Lesenden, und das zu Recht: Eine Linse im Singular stellt eine Frage scharf. Die Rollengrammatik öffnet den Singular dort, wo eine Entscheidung vom Unterschied abhängt, den er verdeckt – zwischen Schreibenden, zwischen Lesenden, zwischen den Systemen, die dazwischen zusammenstellen –, und schließt ihn wieder, wo nichts davon abhängt.
Die Rollengrammatik unterstützt Dokumentationsentscheidungen. Sie ersetzt nie die Zielgruppenanalyse, die Risikobeurteilung, die Entscheidungen des Betreibers über Qualifikation und Befugnis, die für ein Produkt erforderlichen Sicherheitsinformationen oder die Prüfung durch die für die Dokumentation verantwortlichen Menschen. Keine Qualifikationsstufe rechtfertigt je, sicherheitsrelevante Informationen wegzulassen, und eine benannte Rolle begründet nie Konformität.
Cut complexity — create clarity
Verwandte etablierte Methoden
Die Rollengrammatik ist ein eigenes Modell. Normen, Gesetze und etablierte Methoden beschreiben Teile desselben Felds von anderen Seiten. Dieser Abschnitt nennt sie und sagt, wie sich die Rollengrammatik zu ihnen verhält; er ist nicht Teil der Rollengrammatik selbst.
Personen nach elektrotechnischer Qualifikation (IEC 60050-826)
Das Internationale Elektrotechnische Wörterbuch unterscheidet den Laien, die (elektrotechnisch) unterwiesene Person – von Elektrofachkräften unterrichtet oder beaufsichtigt – und die Elektrofachkraft, die durch Ausbildung und Erfahrung Risiken erkennen und Gefährdungen durch Elektrizität vermeiden kann. Die Qualifikationsachse verwendet diese Begriffe, wo es um elektrische Gefährdungen geht.
Qualifizierte und befähigte Personen im Arbeitsschutz
Der Arbeitsschutz unterscheidet die qualifizierte Person, die die Fähigkeiten und Kenntnisse für eine Aufgabe nachgewiesen hat, von der befähigten Person, zu deren Definition die Befugnis zum Handeln gehört. Die Rollengrammatik hält dieselbe Unterscheidung auf zwei Achsen: Qualifikation und Befugnis.
Zielgruppenanalyse (IEC/IEEE 82079-1)
IEC/IEEE 82079-1 verlangt, dass Nutzungsinformationen auf der Zielgruppe beruhen: ihren Aufgaben, Fähigkeiten, Qualifikationen, ihrer Sprache und Umgebung. Die Rollengrammatik ergänzt, dass die Zielgruppe eine Kombination aus Qualifikation, Befugnis und Situation ist und dass dieselben Achsen für die Menschen und Systeme gelten, die die Information schreiben und zusammenstellen.
Der Laie nach der MDR
Die Verordnung (EU) 2017/745 definiert einen Laien als eine Person ohne formale Ausbildung in einem einschlägigen Bereich des Gesundheitswesens oder der Medizin und stellt Anforderungen an Produkte, die für Laien bestimmt sind. Das ist ein Beispiel für eine Qualifikationsstufe, die ein Gesetz definiert und die Dokumentation ansprechen muss.
Fertigkeits-, regel- und wissensbasiertes Verhalten
Jens Rasmussen (1983) unterschied geübte Routinehandlungen, Regeln, die auf vertraute Situationen angewendet werden, und wissensbasiertes Schlussfolgern in neuen Situationen. Dieselbe Person wechselt mit der Situation zwischen den Ebenen – deshalb hält die Rollengrammatik Situation und Qualifikation auf zwei Achsen.
Funktionstrennung und rollenbasierte Zugriffskontrolle
Informationssicherheit und interne Kontrolle halten Aufgaben auseinander, die nicht bei einer Rolle liegen dürfen, und vergeben Rechte an Rollen statt an Personen. Die Familien „Schreiben“ und „Entscheiden“ und die Befugnisachse wenden denselben Gedanken auf die Dokumentation an.
Fachexperten und Technische Redakteure
Die Praxis der Technischen Kommunikation beschreibt den Fachexperten als Quelle des Fachwissens, das die Technische Redakteurin zu nutzbarer Information macht. Die Familie „Schreiben“ benennt beide als Schreibende mit verschiedenen Rollen: Der Experte liefert, die Redakteurin formuliert.
Menschliche Aufsicht über KI-Funktionen und Agenten
Human-in-the-Loop-Gestaltung, Bestätigungsschritte und das Risiko übermäßiger Handlungsfreiheit beschreiben, wie Menschen die Kontrolle über KI-Funktionen und Agenten behalten. Die Akteurs- und die Befugnisachse sagen für jede Rolle, ob ein Mensch jedes Ergebnis prüft, jede Handlung bestätigt oder die Grenze vorab setzt.
Die Glossare erscheinen auf US-Englisch.
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.
- Die Rollengrammatik: Lesen, Schreiben und ZusammenstellenWie sagt man, wer was mit einer technischen Information tut – wenn „der Schreibende“, „die Maschine“ und „der Lesende“ zu grob sind?Karte lesen
- Eine Schreibende, viele SchreibendeWer schreibt einen technischen Text – und warum ist es wichtig, dass es nicht eine Person ist?Karte lesen
- Drei Bediener, ein WarnhinweisWarum braucht derselbe Warnhinweis für eine unterwiesene Bedienerin, einen geschulten Bediener und eine Elektrofachkraft unterschiedliche Informationen?Karte lesen
- Die Antwortfunktion stellt zusammen – sie liest nichtIst eine KI-Antwortfunktion eine Lesende der Dokumentation?Karte lesen
- Die Maschine ist ein Netz, kein MonsterWenn eine KI-Antwort falsch ist, warum ist „die Maschine hat sich geirrt“ keine Diagnose?Karte lesen
- Von Berufsgruppen zu RollenWarum zeigt ein Raster aus Berufsgruppen – Redaktion, Marketing, Projektleitung, Entwicklung, der Lesende, der KI-Agent –, wer beteiligt ist, aber nicht, wer was tut?Karte lesen
- Von drei Lesern zu PrüfrollenDie Startseite nennt drei Leser – die Quelle, den Menschen und den dritten Leser. Warum genügt das, um eine Prüfmethode zu entwerfen, und was muss sich ändern, bevor eine Prüfung laufen kann?Karte lesen
Aktualisierungen der Verweise
Die Glossarverweise, die Begriffe unter „Verwandte etablierte Methoden“ und die Context Cards sind diesem Blueprint beigestellt, nicht Teil von ihm. Sie werden eigenständig geprüft und aktualisiert, ohne neue Ausgabe.
Die Verweise wurden seit der ersten Ausgabe nicht aktualisiert.
Zitiervorschlag
Saina Veigel (2026): Die Rollengrammatik technischer Information: Lesen, Schreiben und Zusammenstellen. Blueprint, Ausgabe 1. knowledge.aitechdoc.world. https://knowledge.aitechdoc.world/de/blueprints/rollengrammatik-technischer-information
Ausgabe und Änderungen
Ausgabe 1 · Geprüft
Korrekturen (etwas war falsch) und Ergänzungen (etwas fehlte) seit der ersten Ausgabe sowie redaktionelle Überarbeitungen der deutschen Übersetzung.
Seit der ersten Ausgabe gab es keine Korrekturen oder Ergänzungen.
Zu diesem Blueprint
Diese Prüfstrategie führt von einem Denkmodell zu einer Prüfmethodik. Sie ist keine Norm, keine zertifizierte Methode und kein Compliance-Rahmen. Wird eine Norm, ein Gesetz oder eine etablierte Methode genannt, heißt das nicht, dass ein Produkt, ein System oder seine Dokumentation ihr entspricht.
Die Prüfregeln, die ein Team damit baut, sind Prüfungen von Dokumentation und Daten. Sie ersetzen weder die Risikobeurteilung des Herstellers noch das Konfigurationsmanagement, die Verifikation und Validierung von Sicherheitsfunktionen oder die Prüfung durch die für die Dokumentation Verantwortlichen.
Copyright © 2026 Saina Veigel. Alle Rechte vorbehalten. Urheberrechtshinweis