Blueprints
Blueprints
Blueprints sind eigene Werke für die Technische Dokumentation, geschrieben und gepflegt von Saina Veigel. Jeder Blueprint ist ein Plan, der gezeichnet wird, bevor etwas gebaut wird. Jeder Blueprint gehört zu genau einer Kategorie: Denkmodelle, die die Fragen scharf stellen, Prüfstrategien, die daraus Prüfmethodiken machen, Nachweis-Blueprints, die eine Aussage belastbar machen, und Denkfunktionsmodelle des arbeitenden Denkens. Es sind Werke ihrer Autorin, hier in ihrer maßgeblichen Fassung veröffentlicht.
Jeder Blueprint nennt seine Autorin, seine Ausgabe und den Ort, an dem seine Gedanken zuerst erschienen sind.
Denkmodell
Denkmodelle
Denkmodelle zeigen, wie ein Dokumentationsthema durchdacht wird, bevor etwas gebaut wird. Sie arbeiten mit bewussten Platzhaltern – der Schreibende, der Lesende, die Maschine –, damit die Fragen scharf werden.
Denkmodell · Ausgabe 1
Denkmodelle für Technische Redakteure
Wie Technische Redakteure Komplexität strukturieren, bevor sie schreiben
Zehn Denkmodelle von Saina Veigel, mit denen Technische Redakteure Komplexität vor dem Schreiben strukturieren – mit Mental Model Stack und Betriebsarten-Raster.
10 Denkmodelle: Denken in ersten Prinzipien · Information Mapping · Komponentendenken · Systemdenken · Aufgabendenken · Risikodenken · Variantendenken · Metadatendenken · Denken in Publikationslogik · Klarheitsdenken
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnenDenkmodell · Ausgabe 2
Kognitive Psychologie für die Technische Kommunikation
Der Reader’s Stack: wie Leser technische Information aufnehmen, verstehen und danach handeln
Der Reader’s Stack von Saina Veigel: zehn Ebenen, wie Dokumentation im Kopf der Leser wirkt – mit Raster der Nutzungssituationen und Abgleich.
10 Denkmodelle: Bemerken (wahrnehmen) · Finden · Sich orientieren · Verstehen · Modell bilden · Im Kopf behalten · Erinnern · Entscheiden · Handeln · Wiederherstellen
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnenDenkmodell · Ausgabe 2
KI-gestützte Informationssysteme für Technische Redakteure
Der Machine’s Stack: wie aus Dokumentation Wissen wird, das Menschen und KI-Systeme nutzen können
Der Machine’s Stack von Saina Veigel: zehn Ebenen, wie Dokumentation zu gesteuertem, nachvollziehbarem Wissen für Menschen und KI wird.
10 Denkmodelle: Abgrenzen · Verankern · Bedeutung modellieren · Einheiten bilden · Kontext beschreiben · Mit dem Produkt verbinden · Abrufen und anpassen · Nachvollziehen · Steuern · Weiterentwickeln
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnenDenkmodell · Ausgabe 2
KI-Systeme und die Maschine: Ebenen und Grenzen
Eine Kaskade von Definitionen für das Netzwerk hinter jeder KI-Antwort
Fünf Ebenen, die Maschine quer durch sie und zwei Grenzen von Saina Veigel: wo KI-Systeme enden und wo die Maschine in ein Unternehmen hineinreicht.
8 Denkmodelle: Globale KI-Umgebung · Vereinbarter Zugang · KI-Bestand des Unternehmens · KI-Systeme · KI-Funktion · Die Maschine · Nicht konfigurierte KI-Nutzung · KI-System (KI-Verordnung)
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnenDenkmodell · Ausgabe 1
Zeitalter der KI: Phasen, Kontrollpunkte und Grenzen
Elf Stufen, ein Gate und zwei Grenzbereiche für die Dokumentation, die auch von der Maschine gelesen wird
Elf Phasen, ein Gate und zwei Grenzbereiche; von Saina Veigel: Wer entscheidet in den einzelnen Phasen eines KI-geführten Content-Lebenszyklus; und was bleibt übrig?
15 Denkmodelle: Analysiere · Modell · Content-Erstellung · Verifiziere · Die Quelle genehmigen · Verwalten und versionieren · Translate and localize · Veröffentlichen und bereitstellen · Answer · Use and feed back · Maintain, withdraw and archive · The gate · Governance · Boundary · Source content and AI-derived output · Boundary · Answers outside the company
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnen
Prüfstrategie
Prüfstrategien
Prüfstrategien führen vom Denkmodell zur Prüfmethodik. Sie öffnen die Platzhalter zu Rollen und die Rollen zu Systemen, Teilsystemen, Funktionen und Teilfunktionen, die eine Prüfregel benennen kann – damit ein Team seine eigenen Prüfprozesse und Prüfregeln bauen kann.
Prüfstrategie · Ausgabe 1
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 Rollengrammatik von Saina Veigel: vier Achsen für alle, die technische Information schreiben, entscheiden, zusammenstellen oder nutzen.
10 Teile: Schreiben · Entscheiden · Zusammenstellen · Nutzen · Zurückschreiben · Der Akteur · Qualifikation · Befugnis · Situation · Der Rollensatz
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnenPrüfstrategie · Ausgabe 1
Wer entscheidet, welcher Wert gilt: Rollen der Produktinformation von der Quelle bis zur Antwort
Von drei Platzhaltern zu Rollen, die eine Prüfregel benennen kann – für jedes System und jede Person, die ein Wert auf seinem Weg passiert
Eine Prüfstrategie von Saina Veigel: drei Platzhalter, geöffnet zu Rollen, damit Teams Prüfregeln für Produktinformation bauen können.
12 Teile: Quelle · System of Record · Stammdaten · Integration · Abgeleitete Daten · Dokumentzusammenstellung · Austauschpaket · Konsumierendes System · System of Engagement · Person · Handelndes System · Stewardship und Lineage
Von Saina Veigel · Zuerst veröffentlicht
Blueprint öffnen
Denkfunktionsmodell
Denkfunktionsmodelle
Denkfunktionsmodelle beschreiben, wie ein Mensch ein Thema durchdenkt – in Bildern, als metaphorische Gedankenmodelle. Sie handeln nicht von Maschinen, Systemen oder den Rollen rund um technische Information. Deshalb stehen sie für sich und gehören nicht zur Reihe „Methodischer Feinschliff“.
Methodenwerkzeuge
Methodenwerkzeuge
Methodenwerkzeuge machen aus einer Prüfstrategie eine Arbeitsform: Bausteine, Vorlagen, ein durchgerechnetes Beispiel und eine Checkliste, mit denen Sie Ihre eigenen Prüfregeln schreiben.