Blueprint · Lifecycle
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
Ein Steuerungssystem, keine Pipeline.
- Von
- Von Saina Veigel · Communications Specialist · Senior Technical Writer
- Ausgabe
- 1
- Zuerst veröffentlicht
- Geprüft
Dokumentation endet nicht mehr mit ihrer Veröffentlichung. Eine KI-Funktion formuliert sie in dem Moment neu, in dem ein Nutzer danach fragt – anhand von Quellen, die der Nutzer nie zu Gesicht bekommt –, und das Ergebnis ist nicht mehr der ursprünglich veröffentlichte Text. Gleichzeitig entwirft, prüft, übersetzt und klassifiziert die KI Inhalte innerhalb des Lebenszyklus. Beide Prozesse treffen an derselben Stelle aufeinander: an dem Punkt, an dem jemand eine Entscheidung trifft.
Dieser Leitfaden unterteilt diese Arbeit in elf Phasen, ein Kontrolltor, eine übergreifende Steuerung der Phasen und zwei Abgrenzungen. Dabei wird durchgehend ein einziger Maßstab angelegt: Wer kann hier etwas entscheiden oder ändern? Die Phasen unterscheiden sich nicht durch die verwendeten Werkzeuge oder Medien. Sie unterscheiden sich vielmehr danach, wer die Entscheidungsgewalt hat und welche Nachweise verbleiben, wenn die Arbeit fortgesetzt wird.
Es baut auf zwei auf dieser Website veröffentlichten Entwürfen auf. Der „Stack“ der Maschine beschreibt, was die Maschine liest; die „Kaskade“ beschreibt, wo die Maschine in ein Unternehmen eingreift. Dieser Entwurf beschreibt die Phasen, in denen diese Inhalte festgelegt, veröffentlicht und beantwortet werden – und er verwendet die Begriffe „KI-Systeme“ und „die Maschine“ genau so, wie sie dort definiert sind.
Es richtet sich an technische Redakteure, technische Projektmanager und Entwickler von Dokumentationssystemen, die für jeden Text festhalten müssen, in welcher Phase er sich befindet, wer darüber entschieden hat und was von dieser Entscheidung anschließend übrig bleibt.
Warum der Lebenszyklus Phasen benötigt
Die Dokumentation wird nun neu formuliert, bevor sie gelesen wird. Autoren können zwar nicht jede Antwort der Maschine kontrollieren, aber sie können wissen, in welcher Phase eine Entscheidung getroffen wird und was danach davon übrig bleibt. Ohne diese Phasen treten häufig zwei Fehler auf: Entweder wird jedes Tool, das mit dem Inhalt in Berührung kommt, als Teil des Lebenszyklus gezählt, oder es wird nach der Veröffentlichung überhaupt nichts mehr dokumentiert.
Beide Fehler betreffen denselben Ort: das Gate, an dem eine Person etwas freigibt und dafür die Verantwortung übernimmt. Dort wird eine Version festgelegt, dort wird eine Änderung nachvollziehbar, und dort liegt die Verantwortung für Sicherheitsinformationen.
Die einzelnen Phasen sind nicht alle gleichermaßen kostspielig. Manche Fehler lassen sich mit der nächsten Version korrigieren. Andere lassen sich nicht rückgängig machen: eine Antwort, die einen Nutzer erreicht hat, eine falsche Warnung, die gelesen wurde, eine Rücknahme, die keine Spuren hinterlassen hat, abgeleiteter Text, der in einen Trainingsdatensatz gelangt ist. Dort, wo ein Fehler nicht rückgängig gemacht werden kann, muss die Sicherheitsvorkehrung am strengsten sein.
Hinter einer einzelnen Antwort des Assistenten auf einem Bedienfeld verbergen sich in der Regel:
- Eine Frage eines Nutzers, die in der aktuellen Situation des Produkts gestellt wird
- veröffentlichte Dokumentation, Produktdaten und Metadaten, die bei der Abfrage ausgewählt werden
- eine Modellversion, ein Gateway und Einstellungen, die festlegen, welche Modellantworten verwendet werden
- unternehmensweite Terminologie, Regeln und Überprüfungsprotokolle
- Die Freigabe der Antwortfunktion: Welche Quellen darf sie nutzen und wo muss sie aufhören?
- die Antwort selbst, in diesem Moment geschrieben und nirgendwo sonst
Jede dieser Phasen gehört zu einer anderen Stufe, und über jede wird von jemand anderem entschieden. Die Phasen machen dies deutlich.
Technische Redakteure müssen nicht jede Phase kontrollieren. Sie müssen wissen, in welcher Phase eine Entscheidung ansteht, damit sie diese dort dokumentieren können, wo sie getroffen werden kann.
The core problem
In a pipeline that nobody owns, the handover is mistaken for the decision.
- AI drafts are treated as sources, and the source of truth drifts.
- A warning is shortened because a summary sounded complete.
- A translation is released without being post-edited against the source text.
- The model behind an answer function changes, and nobody checks the answers again because no content changed.
- Company-wide terminology is fixed inside one project and lost in the next.
- User questions change content directly, without passing the gate.
- Text from outside lands in the corpus and is answered from as if someone had released it.
- The answer is documented, and the source behind it is not.
- A legal assessment is read into a technical stage, or a technical stage into a legal one.
When the stages are mixed up, documentation ends up describing the wrong owner — and a decision that nobody can find can’t be corrected.
Blueprints
Die Phasen
Elf Stufen, das Tor, die Regierungsführung und zwei Grenzen
Die Phasen reichen vom Bedarf bis zum Archiv. Jede Phase beantwortet eine Testfrage, und jede Antwort führt zu einer Entscheidung, die in der Dokumentation festgehalten werden kann. Das Tor, die Governance und die beiden Grenzen folgen den Phasen: Das Tor wird bei mehreren davon passiert, die Governance zieht sich durch alle Phasen, und die Grenzen legen fest, was keine Quelle ist und worüber das Unternehmen nicht entscheidet.
Seitlich scrollen, um alle Spalten zu sehen.
| Phase, Gate, Governance oder Grenze | Testfrage / Prüfungsfrage | Entscheidung zur Dokumentation |
|---|---|---|
| Analysiere | Wessen zugeteilte Aufgabe entscheidet darüber, was benötigt wird? | Bedarfe und Aufgaben · verwendete Quellen · Geltungsbereich und Ausschlüsse · Offene Fragen |
| Modell | Ist dies eine Einheit oder ein Kontainer? | Einheiten und ihre Grenzen · Metadaten · Terminologie · Abhängigkeiten (Relations) |
| Content-Erstellung | Ist dieser Text eine Quelle oder eine Kopie? | Der Text · Die Quellen des Textes · Was hat die KI entworfen, und was hat ein Mensch geändert? · Offene Punkte |
| Verifiziere | Lässt sich jede Behauptung auf eine Quelle zurückführen? | Durchgeführte Prüfungen · Ergebnisse und deren Abschluss · Was noch offen ist · wer hat überprüft |
| Die Quelle genehmigen | Wer veröffentlicht das und zu welchem Zweck? | Wer hat was wann veröffentlicht? · versioniere · scope: languages, variants, channels · open items at release |
| Verwalten und versionieren | Welche Version ist die maßgebliche Quelle? | Versionsverlauf · Was hat sich geändert und warum? · Was hängt von dieser Version ab? · Wie abgeleitete Ergebnisse gekennzeichnet werden |
| Translate and localize | Was the translation post-edited against the source? | The post-edited version · terminology and controlled language · changes against the machine output · Veröffentlichung der Sprachversion |
| Veröffentlichen und bereitstellen | Where does the reader find it — and where does the machine? | Published artifacts and their metadata · the version they were built from · channels · what is not published |
| Answer | Can the answer be traced back to the source it was built from? | Release of the answer function · its allowed sources · what it may never leave out · trace to sources and model version · what happens without a source |
| Use and feed back | What comes back, and who checks it? | What came back and from where · what was decided · where the change was applied · what stays open |
| Maintain, withdraw and archive | Who decides that it is no longer valid? | What was withdrawn, when and why · what replaced it · what remains archived and where · who decided |
| The gate | Who passes it, by name — and for what? | Who · what and in which version · scope · open items · date and time |
| Governance | Which rules apply at every stage, and where are they kept? | Usage policy for AI in documentation · roles and gates · risk classes of content · which content may go to which service · records and retention |
| Boundary · Source content and AI-derived output | Is this a source, or was it derived from one — or does it come from outside? | Mark derived output as derived · keep it out of the source and the corpora · decide what may be fed back, through which gate · keep foreign text out of the corpus |
| Boundary · Answers outside the company | Did anyone in the company configure this answer? If not, it is here. | What is published · how it is marked · what stays unpublished · what the documentation doesn’t promise |
Eine Möglichkeit, darzustellen, wo eine Entscheidung angesiedelt ist, wer sie trifft und was davon übrig bleibt.
Ein Steuerungssystem, keine Pipeline.
Decisions, limits and evidence · Reference
Die Phasenübersicht
In jeder Phase wird entschieden, was die KI tun darf und was nicht, was bestehen bleibt und was nicht rückgängig gemacht werden kann
In jeder Zeile wird aufgeführt, wer in dieser Phase entscheidet, was die KI dort tun darf, was sie nicht tun darf, was als Nachweis verbleibt, ob ein Fehler in dieser Phase rückgängig gemacht werden kann und was unverändert bleibt. Die Spalte „Kann es rückgängig gemacht werden?“ legt die Prioritäten fest: Wo ein Fehler nicht rückgängig gemacht werden kann, muss die Sicherheitsstufe am höchsten sein.
Seitlich scrollen, um alle Spalten zu sehen.
| Phase | Wer entscheidet | KI darf | KI darf nicht | Verbleibende Nachweise | Lässt sich das rückgängig machen? | Was sich nicht ändert |
|---|---|---|---|---|---|---|
| Analisiere | Der Dokumentationsverantwortliche in Zusammenarbeit mit dem Produktmanagement und den Anwendern | Vorhandene Quellen lesen und gruppieren, Lücken aufdecken, eine Reihe von Themen vorschlagen | Entscheide, was das Produkt erfordert · verwirf bestimmte Pflichtaufgaben, wenn sie eher selten auftreten | Der analysierte Bedarf, seine Ursachen, der vereinbarte Umfang und das, was nicht berücksichtigt wurde | Ja, bevor überhaupt etwas geschrieben wird. Eine nach der Veröffentlichung entdeckte Lücke erfordert einen erneuten Durchlauf aller nachfolgenden Phasen. | Die für das Produkt erforderlichen Informationen · Sicherheitshinweise bleiben vollständig |
| Modell | Der Informationsarchitekt und der Terminologiebeauftragte | Einheiten, Metadaten und Beziehungen aus vorhandenen Inhalten vorschlagen | Bedeutung definieren · einen Begriff mit einer anderen Bedeutung wiederverwenden | Das Modell, seine Einheiten, seine Metadaten, die verwendete Terminologie | Ja, aber spätere Änderungen wirken sich auf alle Einheiten aus, die auf diesem Modell basieren. | Die Bedeutung liegt im Modell, nicht im daraus generierten Text |
| Erstelle | Der Autor | Entwerfen, umstrukturieren, zusammenfassen, Formulierungsvorschläge machen, Vorab-Übersetzungen veranlassen | Eine Tatsache, einen Wert oder einen Warnhinweis erfinden · eine Sicherheitsanweisung entfernen | Der Entwurf, seine Quellen, was die KI entworfen hat und was der Autor geändert hat | Ja, solange der Entwurf noch nicht das Tor passiert hat | Der Autor haftet für den Text |
| Überprüfen | Der Gutachter, der über Fach-, Sicherheits- oder Rechtskenntnisse verfügt, sofern der Inhalt dies erfordert | Auf Übereinstimmung mit den Quellen, auf Terminologie, Stil und Vollständigkeit prüfen und Feststellungen kennzeichnen | Release · declare content correct, complete or compliant | Prüfprotokoll: Was wurde anhand welcher Quelle überprüft, offene Feststellungen, wer hat sie abgeschlossen | Ja · Eine Überprüfung, die nie stattgefunden hat, lässt sich im Nachhinein nicht nachweisen. | Die Überprüfung erfolgt anhand der Quelle, niemals anhand einer anderen Ausgabe. |
| Die Quelle genehmigen | Der verantwortliche Inhaber der Inhalte – eine namentlich genannte Person | Die Veröffentlichung vorbereiten und auflisten, was noch offen ist | Genehmigen, unterzeichnen oder die verantwortliche Rolle übernehmen | Wer hat was wann in welcher Version für welchen Anwendungsbereich und mit welchen offenen Punkten veröffentlicht? | Erst ab der nächsten Version – was inzwischen gelesen wurde, bleibt gelesen | Die Verantwortung für veröffentlichte Inhalte liegt bei der Person, die diese veröffentlicht hat. |
| Verwalten und versionieren | Der Inhaber der Inhalte (=Content Owner) im Rahmen des Änderungsprozesses | Versionen vergleichen, Änderungen zusammenfassen, darlegen, worauf sich eine Änderung auswirkt | Hintergrund ändern · abgeleiteten Text in den Quelltext einfügen | Die Versionshistorie: Was hat sich geändert und warum, wovon hängt es ab? | Ja, denn obwohl die Historie zwar vollständig ist, so kann eine stille Änderung sich jedoch u.U. nicht nachvollziehen lassen. | Die veröffentlichte Version ist die maßgebliche Quelle. |
| Übersetzen und lokalisieren | Der Übersetzungsleiter und der Terminologiebeauftragte pro Sprache sowie der Gatekeeper für die jeweilige Sprachversion | Vor der Übersetzung Terminologie und kontrollierte Sprache anwenden, Varianten vorschlagen | Eine Übersetzung veröffentlichen, die nicht anhand des Ausgangstextes nachbearbeitet wurde · Sicherheitshinweise entsprechend anpassen | Die nachbearbeitete Fassung, die verwendete Terminologie, die Änderungen gegenüber der maschinellen Übersetzung, wer die Sprachversion freigegeben hat | Erst ab der nächsten Version · Eine falsche Warnung in einer Sprache ist für jeden Leser dieser Sprache falsch. | Der Ausgangstext gibt den Ton an; die Übersetzung dient ihm |
| Veröffentlichen und bereitstellen | Der Herausgeber | Varianten erstellen, Links und Metadaten prüfen, Vorschauen und strukturierte Daten generieren | Publish content that wasn’t released · change meaning during conversion | Das veröffentlichte Artefakt, seine Metadaten, die Version, auf deren Grundlage es erstellt wurde, sowie die Informationen, die bewusst nicht veröffentlicht wurden | Nur teilweise – das, was veröffentlicht wurde, wurde von Menschen und von der Maschine außerhalb des Unternehmens gelesen | Veröffentlicht wird das, was herausgegeben wurde |
| Antwort | Der Verantwortliche für Antworten und Bereitstellung gibt die Antwortfunktion frei; die Inhaber der Inhalte haften für deren Quellen | Veröffentliche Inhalte für die jeweilige Frage umformulieren, zusammenfassen, übersetzen und kombinieren | Eine Antwort geben, die über die veröffentlichten Quellen hinausgeht · eine Warnung, eine Einschränkung oder erforderliche Informationen weglassen · eine Quelle erfinden | The release of the function, and per answer its sources, the model version and the time | Nein – ein Anruf, der bereits bei einem Nutzer angekommen ist, kann nicht zurückgerufen werden | Die Antwort dient der Quelle; die Quelle ist nicht die Antwort. |
| Use and feed back | Der Verantwortliche für die Dokumentation in Zusammenarbeit mit dem Produktsupport und den Anwendern | Fragen bündeln, fehlende Themen ausfindig machen, Vorschläge machen, wo Inhalte lückenhaft sind | Benutzerfragen ohne Einschränkung in Quellinhalte umwandeln – abgeleitete Texte als Quelle nutzen | What came back, from where, what was decided, where the change was applied | Ja, solange das Feedback außerhalb der Quelle bleibt, können abgeleitete Texte in einem Trainingssatz nicht wieder entfernt werden. | Die Rückkopplung verändert die Quelle durch das Gate hindurch, nicht um es herum |
| Pflegen, zurückziehen und archivieren | Der Inhaber der Inhalte gemeinsam mit dem Verantwortlichen für den Produktlebenszyklus | Betroffene Inhalte ausfindig machen, Vorschläge zur Entfernung unterbreiten, den Überblick behalten | Noch benötigte Inhalte zurückziehen · die Spuren einer zurückgezogenen Version löschen | Was wurde zurückgezogen, wann, warum und wodurch wurde es ersetzt? | Eine Rücknahme kann rückgängig gemacht werden – eine gelöschte Spur hingegen nicht. | Eine zurückgezogene Version bleibt nachverfolgbar |
Die Tabelle lässt sich in Verbindung mit der Übersichtstabelle des Entwurfs „KI-Systeme und die Maschine: Ebenen und Grenzen“ lesen: Während diese Tabelle angibt, wo im Netzwerk eine Entscheidung getroffen wird, gibt diese Tabelle an, in welcher Phase des Lebenszyklus sie getroffen wird.
In jeder Phase gibt es jemanden, der Entscheidungen trifft – und jede Entscheidung hinterlässt Spuren.
The stages and the machine’s stack
The crosswalk
Each stage next to the layers of the machine’s stack that it prepares
The stages can be read next to the machine’s stack of the blueprint “AI-enabled information systems for technical writers”. Its ten layers describe what the machine finds where it reaches into a company; the crosswalk shows which stage prepares which layer. The mapping is not one to one: a stage can prepare several layers, and one boundary prepares none, because it lies outside the company.
Seitlich scrollen, um alle Spalten zu sehen.
| Stage, gate, governance or boundary | Layers of the machine’s stack | What the machine reads there |
|---|---|---|
| Analyze | Bounding | What the documentation covers, and what it never promises |
| Model | Modeling meaning · Building units · Describing context | Units, terms and relations with a defined meaning, and the metadata that says for whom and when |
| Create | Building units | Units that stand on their own, with the safety information inside the unit |
| Verify | Anchoring · Tracing | The source a statement rests on, and the review status |
| Approve the source | Governing · Anchoring | The version that counts as released |
| Manage and version | Anchoring · Tracing | Which version is the source of truth, and what changed |
| Translate and localize | Describing context | Language, market and validity of each version; the stack has no layer of its own for language |
| Publish and deliver | Connecting to the product · Describing context | The device, line or system the content belongs to, and the variant |
| Answer | Retrieving and adapting · Bounding | The released sources selected for one question, and where the function must stop |
| Use and feed back | Evolving · Tracing | What was asked, what failed, what was decided |
| Maintain, withdraw and archive | Tracing · Evolving | What still applies and what was withdrawn |
| The gate | Governing | Who released what, and for which scope |
| Governance | Governing | The rules that apply to every layer |
| Boundary · Source content and AI-derived output | Anchoring | What is a source and what was derived from one |
| Boundary · Answers outside the company | None | Only what was published, and how it was marked |
Language has no layer of its own in the machine’s stack: it is part of the context. Answers outside the company have no layer at all, because the machine’s stack begins where a company configures.
The stages prepare what the machine reads. Where no stage prepares it, the machine reads it anyway.
Trade-offs · Reference
Where the stages work against each other
Each conflict with the stages it sets against each other, who decides and what prevails
A decision that helps one stage can harm another. The conflicts don’t go away by being ignored; they are decided anyway, only nobody knows by whom. Each row names a conflict, the stages it concerns, who decides it and what prevails when in doubt.
Seitlich scrollen, um alle Spalten zu sehen.
| Conflict | Stages | Who decides | What prevails when in doubt |
|---|---|---|---|
| Speed of drafting against depth of verification | Create · Verify | The content owner, by the risk of the content | Verification · for safety-related and required information always |
| Localization against fidelity to the source | Translate and localize · Approve the source | The translation lead, with the content owner | The source · form and context may adapt, the required information may not |
| A short answer against complete warnings | Answer · Approve the source | The answer and delivery steward, with the content owners | The warning · an answer that has to leave it out refers to the source instead |
| Urgent feedback against the way through the gate | Use and feed back · Approve the source | The documentation owner | The gate · an urgent correction passes it faster, never around it |
| Reuse of a unit against its context | Model · Create · Publish and deliver | The information architect | The context · a unit that needs another context becomes another unit |
| Recording answers against data minimization | Answer · Use and feed back · Governance | Governance, with data protection | A decided rule · what is recorded, for how long and without whose data |
| A model update against stable answers | Answer · Governance | Governance, with the answer and delivery steward | A new check · a changed model is a change in the lifecycle |
The column “Who decides” names roles, not job titles. In a small team one person can hold several of them; the conflict still has to be decided and written down.
A conflict that nobody decides is decided by whoever acts first.
The stages, the gate, governance and the boundaries
Each entry explains one stage, the gate, governance or a boundary: its test question, what it covers, where it ends and what documentation has to decide about it.
- 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
1. Analysiere
Kernfrage: Wessen zugeteilte Aufgabe entscheidet darüber, was benötigt wird?
Die Analyse überträgt ein Produkt, seine Nutzer und deren Situationen in die Anforderungen, denen die Dokumentation gerecht werden muss – noch bevor überhaupt ein Text vorliegt.
Fragen, die man in dieser Phase stellen sollte:
- Welche Aufgaben müssen die Benutzer ausführen, und in welchen Situationen?
- Welche Quellen geben bereits Antworten darauf, und wo widersprechen sie sich?
- Was fällt nicht in den Geltungsbereich, und wer hat dem zugestimmt?
KI ist hier als „Leser“ nützlich: Sie kann vorhandene Handbücher, Tickets und Spezifikationen schneller durchgehen als jeder Mensch und aufzeigen, was darin steht und wo sich Informationen widersprechen. Was sie findet, sind Belege dafür, was vorhanden ist. Es sind keine Belege dafür, was das Produkt erfordert.
Die Analyse legt auch fest, was die Dokumentation niemals versprechen wird. Diese Grenze ist das Erste, was die Maschine wissen muss, und sie kann nur hier gezogen werden.
- Eine Themenliste ist keine Analyse.
- Was vorhanden ist, ist nicht unbedingt das, was den Anforderungen entspricht.
Was niemand analysiert hat, wird später mit dem angereichert, was das Tool zufällig weiß.
Entscheidung zur Dokumentation
- Bedarfe und Aufgaben
- verwendete Quellen
- Geltungsbereich und Ausschlüsse
- Offene Fragen
2. Modell
Kernfrage: Ist dies eine Einheit oder ein Kontainer?
Durch die Modellierung wird der analysierte Bedarf in Einheiten mit Bedeutung, Metadaten und Beziehungen umgewandelt, sodass in jeder nachfolgenden Phase auf derselben Struktur aufgebaut wird.
Fragen, die man in dieser Phase stellen sollte:
- Welche Einheit trägt welche Bedeutung, und wo ist diese Bedeutung festgehalten?
- Welche Metadaten benötigt eine Einheit, damit sie gefunden, wiederverwendet und nachverfolgt werden kann?
- Welche Terminologie wird hier verbindlich festgelegt, und wo wird sie unternehmensweit gepflegt?
Im Modell wird Bedeutung einmal verbindlich festgelegt, damit sie nicht in jedem Text, jeder Übersetzung und jeder Antwort erneut bestimmt werden muss. KI kann auf Grundlage bestehender Inhalte Einheiten und ihre Beziehungen vorschlagen. Festzulegen, was ein Begriff bedeutet, ist jedoch eine Entscheidung. Und diese Entscheidung bleibt eine Entscheidung.
Terminology fixed in one project ends with that project. The model belongs to the company, and the terminology with it.
- Ein Dokument ist keine Einheit.
- Ein wiederverwendeter Satz ist keine modellierte Einheit.
Was nicht modelliert wird, benötigt in einer späteren Phase eine Entscheidung.
Entscheidung zur Dokumentation
- Einheiten und ihre Grenzen
- Metadaten
- Terminologie
- Abhängigkeiten (Relations)
3. Content-Erstellung
Kernfrage: Ist dieser Text eine Quelle oder eine Kopie?
Creation writes the text that will be released: structured, in the terminology of the model, with its sources recorded.
Fragen, die man in dieser Phase stellen sollte:
- Auf welchen Quellen basiert dieser Satz, und sind diese Quellen dokumentiert?
- Welche Teile wurden von der KI entworfen, und was hat der Autor geändert?
- Welche sicherheitsrelevanten Informationen dürfen unter keinen Umständen gekürzt werden?
Ein mit Hilfe von KI verfasster Entwurf ist erst dann ein eigenständiges Werk, wenn der Autor ihn sich zu eigen gemacht hat und er die Endkontrolle bestanden hat. Die Aufzeichnung dessen, was die KI entworfen hat, ist kein Geständnis. Es ist der Beweis dafür, dass sich jemand damit befasst hat.
Ein flüssig formulierter Text verschleiert fehlende Quellen gut. Diese Phase fragt nach der Quelle, die jede Behauptung stützen muss. Sie befasst sich nicht mit der Formulierungs-Qualität des Satzes.
- Ein Entwurf ist keine Quelle.
- Eine Zusammenfassung ist nicht die Information, die sie zusammenfasst.
Jeder Satz, der ohne Quelle in den Prozess gelangt, lässt eine Entscheidung offen.
Entscheidung zur Dokumentation
- Der Text
- Die Quellen des Textes
- Was hat die KI entworfen, und was hat ein Mensch geändert?
- Offene Punkte
4. Verifiziere
Kernfrage: Lässt sich jede Behauptung auf eine Quelle zurückführen?
Bei der Verifizierung wird der Inhalt anhand der Quellen, des Modells und der Produktanforderungen überprüft, und es wird protokolliert, was überprüft wurde.
Fragen, die man in dieser Phase stellen sollte:
- Which claims are checked against which source?
- Was hat die KI geprüft, und was hat ein Mensch geprüft?
- Wie gründlich erfolgt die Überprüfung, wenn man berücksichtigt, welche Folgen ein Fehler in diesem Zusammenhang haben könnte?
- Welche Fälle sind noch offen, und wer schließt sie ab?
KI kann vieles überprüfen: Terminologie, Stil, Vollständigkeit im Vergleich zu einem Modell sowie die Konsistenz zwischen verschiedenen Versionen. Sie kann Inhalte jedoch nicht als korrekt bewerten, da die Korrektheit anhand der Quelle und des Endprodukts gemessen wird, nicht anhand einer anderen Ausgabe.
Nicht jeder Text erfordert denselben Prüfungsumfang. Der Umfang richtet sich nach den möglichen Folgen eines Fehlers: Sicherheitsrelevante und vorgeschriebene Informationen werden stets am gründlichsten geprüft, unabhängig von der Frist.
- Das Abgleichen eines Ergebnisses mit einem anderen Ergebnis ist keine Verifizierung.
- Eine Stilprüfung ist keine inhaltliche Prüfung.
Was nicht anhand einer Quelle überprüft wurde, gilt auch dann nicht als verifiziert, wenn es flüssig formuliert ist.
Entscheidung zur Dokumentation
- Durchgeführte Prüfungen
- Ergebnisse und deren Abschluss
- Was noch offen ist
- wer hat überprüft
5. Die Quelle genehmigen
Kernfrage: Wer veröffentlicht das und zu welchem Zweck?
Die Freigabe des Quellcodes ist der erste und wichtigste Schritt durch das Tor: Eine namentlich genannte Person gibt eine Version frei und übernimmt die Verantwortung dafür.
Fragen, die man in dieser Phase stellen sollte:
- Who is accountable for this content, by name?
- What is still open, and does it have to be closed first?
- Which languages, variants and delivery channels does this release cover?
Everything before this stage proposes. Everything after it depends on it: the version, the translation, the publication and every answer built from the content.
Die Stärke dieses Gates richtet sich danach, was später nicht mehr rückgängig gemacht werden kann. Eine Veröffentlichung, die womöglich in zwanzig Sprachen übersetzt und tausende Male kommentiert werden wird, benötigt ein stärkeres Gate als nur ein kurzen Hinweis auf einer internen Prüfseite.
- Eine abgeschlossene Prüfung ist keine Genehmigung.
- Ein Tool kann eine Version vorbereiten; es kann jedoch nicht die verantwortliche Rolle übernehmen.
Eine Veröffentlichung ohne Namen ist eine Entscheidung, die niemand getroffen hat.
Entscheidung zur Dokumentation
- Wer hat was wann veröffentlicht?
- versioniere
- scope: languages, variants, channels
- open items at release
6. Verwalten und versionieren
Kernfrage: Welche Version ist die maßgebliche Quelle?
Die Verwaltungsfunktion sorgt dafür, dass veröffentlichte Versionen nachvollziehbar sind und mit den Änderungen verknüpft sind, die zu ihrer Entstehung geführt haben.
Questions to ask at this stage:
- Welche Version ist aktuell, und auf welcher Quelle beruht diese Aussage?
- What depends on this version: translations, publications, answer functions?
- What happens to derived output when the source changes?
Once content is released, the machine starts answering from it. Every change of the source changes what the answer functions may say, so the version history is also the history of the answers.
Derived output doesn’t get a version of its own in the source. It is marked as derived and stays where it was used.
- Die neueste Datei ist nicht automatisch die veröffentlichte Version.
- Ein abgeleiteter Text ist keine Version des Ausgangstextes.
Zwei Wahrheiten sind eine Wahrheit zu viel.
Entscheidung zur Dokumentation
- Versionsverlauf
- Was hat sich geändert und warum?
- Was hängt von dieser Version ab?
- Wie abgeleitete Ergebnisse gekennzeichnet werden
7. Translate and localize
Kernfrage: Was the translation post-edited against the source?
Translation carries the released meaning into other languages and markets, and localizes what has to differ without changing what must not.
Fragen, die man in dieser Phase stellen sollte:
- Welche Terminologie wird in dieser Sprache verwendet?
- Was hat das maschinelle Übersetzungssystem übersetzt, und was hat ein Post-Editor geändert?
- Welcher Sicherheitshinweis darf nicht angepasst werden?
- Wer veröffentlicht diese Sprachversion?
Die maschinelle Übersetzung mit Nachbearbeitung ist das älteste Funktionsmodell der KI im Bereich der Dokumentation: Die Maschine erstellt den Text, ein Mensch überarbeitet ihn anhand des Ausgangstextes und übernimmt die Verantwortung für das Ergebnis. Es ist ein gutes Modell für jede weitere Phase.
Jede Sprachversion durchläuft die Prüfung eigenständig. Eine Übersetzung wird nicht veröffentlicht, nur weil die Ausgangsversion veröffentlicht wurde.
- A translated sentence is not a reviewed sentence.
- Localization adapts form and context, not the required information.
The source text decides; the translation serves it.
Entscheidung zur Dokumentation
- The post-edited version
- terminology and controlled language
- changes against the machine output
- Veröffentlichung der Sprachversion
8. Veröffentlichen und bereitstellen
Kernfrage: Where does the reader find it — and where does the machine?
Durch die Veröffentlichung wird die veröffentlichte Version zu den Artefakten und Kanälen, über die Menschen und Maschinen tatsächlich mit ihr in Berührung kommen.
Questions to ask at this stage:
- Which channels and formats serve which task?
- Which metadata travels with the content, so that the machine knows what it is reading?
- Where can a reader or the machine find the current version?
- What is deliberately not published?
Publishing is the last stage at which the company decides alone what can be read. After it, the content is read inside the company by its answer functions and outside by the answer functions of others.
That is why this stage also decides what stays unpublished, and how the published content says what it is, for whom and in which version.
- Ein veröffentlichtes Artefakt ist keine neue Version.
- Die Umrechnung darf die Bedeutung nicht verändern.
Was veröffentlicht wird, ist das, was herausgegeben wurde – oder es handelt sich um eine Sekundärquelle.
Entscheidung zur Dokumentation
- Published artifacts and their metadata
- the version they were built from
- channels
- what is not published
9. Answer
Kernfrage: Can the answer be traced back to the source it was built from?
Answering is the stage at which the machine reformulates released content for one question in one situation, and the user receives a text that nobody released.
Questions to ask at this stage:
- Which sources may this function answer from, and where must it stop?
- Can the answer be traced back to its sources and to the model version it used?
- What happens when no released source answers the question?
- Who checks the answers again when the model, the gateway or the settings change?
Nobody can release every answer. What is released is the answer function: the sources it may use, the warnings, limits and required information it may never leave out, and what it does when it has no source. That release is a passage through the gate like any other, and the answer and delivery steward answers for it.
The machine changes without the content changing. A new model, a new gateway, new settings or a new retrieval index change the answers as much as a new version of the source. A change of the machine is a change in the lifecycle, and it calls for a new check of the function.
- The answer serves the source; the source is not the answer.
- A reformulation is not a release.
- An unchanged source is no proof of unchanged answers.
The lifecycle doesn’t end at publishing. It ends where the answer arrives.
Entscheidung zur Dokumentation
- Release of the answer function
- its allowed sources
- what it may never leave out
- trace to sources and model version
- what happens without a source
10. Use and feed back
Kernfrage: What comes back, and who checks it?
Use produces feedback: questions, errors, missing topics and answers that worked. Feedback changes the source only through the gate.
Questions to ask at this stage:
- Which questions come back that no source answers?
- Which answers were wrong, and which sources and which model version did they use?
- How does a finding become a change of the source?
- What is recorded about the user who asked, and for how long?
Feedback is the stage at which the lifecycle closes into a loop. It is also the stage at which derived text most easily flows back into the source: an answer that worked is copied into a topic, a cluster of questions becomes a page that nobody released.
Questions come from people. Recording them is useful and is also a decision about their data, made once in governance and not anew by every tool.
- A user question is not a requirement.
- Feedback doesn’t edit the source; it starts the next pass.
A correction that stays in the answer never reaches the next reader.
Entscheidung zur Dokumentation
- What came back and from where
- what was decided
- where the change was applied
- what stays open
11. Maintain, withdraw and archive
Kernfrage: Who decides that it is no longer valid?
Maintenance keeps content valid over the life of the product, and withdraws or archives what no longer applies — without losing the trace.
Questions to ask at this stage:
- What still applies after a change of the product?
- Who decides that content is withdrawn, and what replaces it?
- Do the answer functions stop answering from withdrawn content?
- What remains readable after a withdrawal, and for how long?
A withdrawal is a passage through the gate: someone decides that content no longer applies and answers for that decision. It reaches the answer functions only if they stop using the withdrawn version.
Content that is no longer valid is still evidence of what was once released. The trace stays, even when the content goes.
- Archiving is not deleting.
- A withdrawn version stays traceable.
What was released once stays part of the record.
Entscheidung zur Dokumentation
- What was withdrawn, when and why
- what replaced it
- what remains archived and where
- who decided
12. The gate
Kernfrage: Who passes it, by name — and for what?
The gate is not a stage. It is the one form of decision in which a named person releases something and answers for it — and it is passed wherever something is released.
Questions to ask at every gate:
- Who passes the gate, and is that person named?
- What exactly is released: which version, which language, which function, which withdrawal?
- Which items are still open, and were they accepted knowingly?
- How strong does the gate have to be, given what can’t be undone after it?
The gate is passed when a source is released, when a language version is released, when an answer function is released with its sources, when feedback is taken into the source and when content is withdrawn. It is the same gate each time: one person, one release, one record.
A tool can prepare the gate — collect what is open, compare versions, list what a change affects. It can never pass it. Passing the gate is the moment at which responsibility becomes visible, and responsibility can’t be delegated to the machine.
- One gate, passed many times.
- A prepared release is not a release.
Everything before the gate proposes. Everything after it depends on it.
Entscheidung zur Dokumentation
- Who
- what and in which version
- scope
- open items
- date and time
13. Governance
Kernfrage: Which rules apply at every stage, and where are they kept?
Governance is not a stage. It is the set of rules, roles, gates and records that apply at every stage, decided once and referred to everywhere.
Questions to ask across the stages:
- Which rules apply to every project, and where are they written?
- Which content may go into which AI service, and which may not leave the company?
- Into which risk classes is content divided, and how strong is the gate for each?
- Who releases a new answer function, a new source or a new language?
- Which records are kept, for how long, and what do they contain about people?
Governance decides the conflicts between the stages before they arise: how deep a check has to be, what an answer may never leave out, what is recorded about users, and what happens when the model changes.
It also decides what leaves the company. Sources, drafts and unpublished product data travel into the services of others at several stages. Which content may go where is decided once, at the point where the company reaches into the machine, not by every author with every prompt.
- Governance is not a stage you pass.
- A rule kept in one project is not a company rule.
Rules that live in one project end with it.
Entscheidung zur Dokumentation
- Usage policy for AI in documentation
- roles and gates
- risk classes of content
- which content may go to which service
- records and retention
14. Boundary · Source content and AI-derived output
Kernfrage: Is this a source, or was it derived from one — or does it come from outside?
The boundary marks the line between what the company released and answers for and what the machine derived from it. On its other side lies text from outside that nobody in the company released.
Questions to ask at this boundary:
- Is this text a released source or a derived output?
- May derived output flow back into a corpus, a glossary or a training set — and through which gate?
- How is derived output marked where it is used?
- Which text in the corpus was never released by anyone in the company?
When derived text is fed back into the source without the gate, the source of truth thins out with every pass: answers are built from answers, and nobody can say any longer which sentence someone released. Models trained on generated data are known to degrade in the same way; in a company, the effect starts much earlier, in the corpus.
Text from outside is the other side of the same boundary. A supplier document, a forum post or a web page in the corpus is answered from as if someone had released it — and it can carry instructions meant for the machine. Foreign text is not a source until someone in the company has released it.
- Derived is not source.
- Foreign is not source.
- A generated sentence that nobody released is not documentation.
When derived text becomes a source, the source of truth dissolves.
Entscheidung zur Dokumentation
- Mark derived output as derived
- keep it out of the source and the corpora
- decide what may be fed back, through which gate
- keep foreign text out of the corpus
15. Boundary · Answers outside the company
Kernfrage: Did anyone in the company configure this answer? If not, it is here.
Answers outside the company are the answers that search engines, chat assistants and agents of others give from published documentation.
Questions to ask at this boundary:
- Which of our published content is read and answered from outside the company?
- Does the published content say what it is, for whom, for which product and in which version?
- What should not be published, because an answer built from it outside the company could do harm?
Every model of a lifecycle assumes that someone in the company decides. Here nobody does. The user may never see the documentation; they see an answer that another company’s function wrote from it. Noticing, finding and understanding move to the machine, and the person only judges the result.
The company keeps one decision: the one made at publishing. What is published, how clearly it is marked and what is deliberately left out is all that reaches these answers. The cascade calls the corresponding place unconfigured AI use; this boundary is its counterpart on the side of published content.
- Published is not configured.
- An answer outside the company is not the company’s answer — but it is built from the company’s content.
Where the company doesn’t decide the answer, it decides what can be answered from.
Entscheidung zur Dokumentation
- What is published
- how it is marked
- what stays unpublished
- what the documentation doesn’t promise
Why this matters for documentation
The stages turn a pipeline that nobody owns into places where decisions can be documented:
- every stage says who decides and what remains as evidence
- one gate, passed wherever something is released, with a name on every release
- model versions and answers are recorded where they are produced
- a change of the machine is treated as a change in the lifecycle
- company-wide rules are kept once, in governance
- the conflicts between the stages are decided, not left to whoever acts first
- derived output and foreign text are marked instead of becoming sources
- a withdrawal keeps its trace
A decision that can be found can be corrected.
Distinctions to keep
The stages depend on a few distinctions that are easy to blur in everyday language. Each of them is a boundary between two stages, between a stage and the gate, or between a source and something that isn’t one.
- A control system is not a pipeline.
- A draft is not a source.
- A review is not an approval.
- A prepared release is not a release.
- A translated sentence is not a reviewed sentence.
- A published artifact is not a new version.
- An answer is not a source.
- An unchanged source is no proof of unchanged answers.
- Derived is not source, and foreign is not source.
- A user question is not a requirement.
- Archiving is not deleting.
- A stage is not a legal classification.
Each distinction names someone who decides — and someone who doesn’t.
Evidence that is enough
Recording everything is no answer; it is the reason nothing is found. The smallest record that lets a release be traced and corrected holds, for every passage through the gate:
- what was released, in which version and for which scope — languages, variants, channels
- who released it, by name, and when
- which items were open and accepted knowingly
- which checks were made against which sources
- for an answer function: its allowed sources, what it may never leave out, the model version and settings it was released with
- for a withdrawal: why, and what replaced it
An observation counts when it would change a text, a model or the release of a function: a question that no source answers, an answer that left out a warning, a translation that changed a meaning. Everything else is noise and can be counted instead of kept.
The record is needed as long as the product needs its information, and often longer. How long exactly is a legal and contractual question. What the record contains about people — the users who asked, the employees who released — is a decision of governance, made once.
A small record that is kept beats a complete one that nobody can read.
Werkzeuge und die einzelnen Phasen
Verschiedene Tools können die einzelnen Phasen sichtbar machen: ein Content-Management-System mit Versionshistorie, eine Terminologiedatenbank, ein Übersetzungsspeicher mit Post-Editing-Einträgen, ein Gateway, das Modellversionen protokolliert, sowie eine Suchfunktion, die die Quellenangaben anzeigt. Sie zeigen, was geschehen ist.
Sie entscheiden nicht darüber, was veröffentlicht wird oder wer dafür verantwortlich ist. Diese Entscheidung liegt bei einer bestimmten Person, und sie muss schriftlich festgehalten werden, damit in der Dokumentation darauf Bezug genommen werden kann.
Anhand der Phasen kann die Dokumentation:
- Gib für jeden Text an, in welcher Phase er sich befindet und wer darüber entschieden hat.
- trace a changed answer to a changed source or a changed model version
- Terminologie und Regeln an einem zentralen Ort statt in einzelnen Projekten verwalten
- Nenne jeglichen Einsatz von von KI, der in keiner Phase erfasst wird
- trenne die rechtliche Beurteilung von der technischen Beschreibung
Die Werkzeuge zeigen die Arbeit. Die Phasen zeigen, wer entscheidet.
Das Grundprinzip
Das Grundprinzip lässt sich kurz zusammenfassen: ein Steuerungssystem, keine Pipeline.
Jede Phase hängt von der vorhergehenden ab. Nur das, was eine Person durch das Tor freigegeben hat, gilt als Quelle, und nur das, was das Unternehmen beschlossen hat, gilt als Inhalt. Die Maschine liest alles und gehört niemandem.
Die Phasen dienen als Grundlage für Entscheidungen zur Dokumentation. Sie ersetzen in keinem Fall die rechtliche Bewertung der betreffenden KI-Systeme, die Risikobewertung des Herstellers, die für ein Produkt erforderlichen Sicherheitsinformationen oder die Überprüfung durch die für die Dokumentation verantwortlichen Personen. In keiner Phase dürfen sicherheitsrelevante oder vorgeschriebene Informationen ausgelassen oder angepasst werden.
Cut Complexity — Create Clarity
Related established methods
The stages are an original model. Standards, specifications, laws and research describe parts of the same lifecycle from other sides — processes, document states, translation, transparency, liability, provenance. This section names them and says how the stages relate to them; it is not part of the blueprint.
Information for use and document management (IEC/IEEE 82079-1, IEC 82045-1)
IEC/IEEE 82079-1:2019 sets out principles and general requirements for information for use, including requirements on the process by which it is prepared and kept up to date. IEC 82045-1:2001 describes principles and methods of document management, among them the life cycle of a document with its revisions and states. The stages follow a similar path and add the stages that AI brings in and the question of who decides at each of them. The blueprint doesn’t describe these standards, and following it doesn’t fulfil them.
The content lifecycle status in iiRDS
The iiRDS specification records the stage of an information unit in the information development process as a ContentLifeCycleStatus with a status value — such as InReview, Approved or Released — and optionally a date, a comment and the party that performed the transition. It gives a unit a state; the stages give the work around it a decision and a piece of evidence. Naming the specification doesn’t mean that content conforms to it.
Unified content strategy (Rockley)
Managing Enterprise Content: A Unified Content Strategy (Ann Rockley, Pamela Kostur and Steve Manning, 2003; second edition by Ann Rockley and Charles Cooper, 2012) describes content as reusable components that are managed through a content life cycle across an organization. The stages keep that view of content as managed components and ask at every stage what AI may do and who decides. The approach belongs to its authors and is credited, not claimed.
Post-editing of machine translation (ISO 18587)
ISO 18587:2017 sets requirements for the full, human post-editing of machine translation output and for the competences of post-editors; light post-editing is described separately. It is the working model for every review of AI output in this blueprint: the machine produces, a person edits against the source and answers for the result. Naming the standard doesn’t mean that a translation process conforms to it.
Transparency obligations under the EU AI Act (Article 50)
Article 50 of the EU AI Act (Regulation (EU) 2024/1689, as amended by Regulation (EU) 2026/1744) requires, among other things, that people are informed when they interact with an AI system, that synthetic audio, image, video and text output is marked in a machine-readable way and that deepfakes are disclosed. The obligations apply from August 2, 2026; for generative systems already on the market before that date, the marking duty applies from December 2, 2026. Whether and how they apply to a particular documentation function is a legal question that the stages don’t answer.
Product liability (Directive (EU) 2024/2853)
The new Product Liability Directive, Directive (EU) 2024/2853, covers software as a product and applies to products placed on the market after December 9, 2026. Whether a product is defective is assessed with regard to, among other things, its presentation, including the instructions for installation, use and maintenance. The stages show where decisions about that information are made; the legal assessment is not part of the blueprint.
Provenance and Content Credentials (C2PA)
The Coalition for Content Provenance and Authenticity (C2PA) publishes a technical specification for Content Credentials: provenance information that is cryptographically bound to a digital asset and records how it was created and changed. It is one technical way of marking origin at the boundary between source content and derived output; the blueprint doesn’t require any particular implementation.
Model collapse (Shumailov and others)
Ilia Shumailov and his co-authors showed that models trained on recursively generated data lose the less frequent parts of the original distribution and degrade over generations (“The Curse of Recursion”, arXiv, 2023; “AI models collapse when trained on recursively generated data”, Nature, 2024). The boundary between source content and derived output names the organizational form of a similar effect: when derived text is not kept apart from released content, the source of truth thins out. The research is credited as the origin of the effect, not as a model for documentation.
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.
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): Zeitalter der KI: Phasen, Kontrollpunkte und Grenzen. Blueprint, Ausgabe 1. knowledge.aitechdoc.world. https://knowledge.aitechdoc.world/de/blueprints/content-lebenszyklus-unter-ki
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
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