Jede Seite hätte schon vor langer Zeit Seite eins sein können: Sind wir jetzt bereit?

Jede Seite hätte längst Seite eins sein können. Als ich 2014 Mark Bakers Every Page is Page One: Topic-Based Writing for Technical Communication and the Web las, lange bevor künstliche Intelligenz Teil meines täglichen Sprachgebrauchs wurde, erschien mir die Idee zugleich naheliegend und fast unmöglich: Ein Benutzerhandbuch könnte vollständig sein, ohne jeden Leser durch dieselbe Abfolge zu zwingen.

Ich las das Buch nicht als Trendbericht. Ich las es als Erklärung für etwas, das ich in der technischen Dokumentation bereits erlebt hatte: Benutzerhandbücher wurden als lineare Bücher verfasst, während Leser über ein Problem, eine Aufgabe, einen Maschinenzustand, einen Fehlercode oder eine Frage in sie einstiegen.

Das Buch gab dieser Erfahrung einen Namen, eine Struktur und praktische Prinzipien, um die Dinge anders – und besser – zu machen. Es brachte mich außerdem dazu, mir ein Benutzerhandbuch vorzustellen, das sich nicht wie ein Buch verhalten musste, selbst wenn es als PDF ausgeliefert wurde.

Ich begann, von verlinkten Nachschlagewerken zu träumen

Damals wollte ich ein Handbuch erstellen, das sich wie ein Nachschlagewerk verhielt – kein konventionelles Buch, das Leser von vorne bis hinten lesen mussten, sondern ein strukturiertes Referenzwerk, das über verschiedene Routen zugänglich war.

Ich stellte mir eine Orientierungsseite vor, die als Karte der Maschine diente. Von dort aus konnten Leser über Reiter einsteigen für:

• die Aufgabe, die sie ausführen mussten;
• den Maschinenzustand, mit dem sie konfrontiert waren;
• die Komponente, an der sie arbeiteten;
• die Gefährdung, die sie beherrschen mussten;
• den Betriebsmodus, den sie gewählt hatten;
• den Fehlercode, der auf der HMI angezeigt wurde; oder
• die Konfiguration der Maschine, die vor ihnen stand.

Die vertrauten Kategorien – Sicherheit, Installation, Betrieb, Wartung, Störungsbehebung und technische Daten – würden erhalten bleiben. Sie würden als Reiter und Zugangspunkte fungieren und unterschiedliche Such- und Navigationsrouten öffnen, statt eine einzige vorgeschriebene Lesereihenfolge aufzuzwingen.

Ein Thema wie die Prüfung einer Schutztür könnte über Inbetriebnahme, Wartung, Sicherheit oder Störungsbehebung erreicht werden. Der Inhalt würde ein einziges kontrolliertes Thema bleiben, statt an vier Stellen kopiert zu werden.

Das war die Form, die ich erkennen konnte, bevor es eine praktische Umgebung gab, um sie umzusetzen: keine Abfolge von Seiten, sondern ein navigierbares Referenzsystem, das sich daran orientiert, wie Menschen tatsächlich an eine Maschine herangehen.

„Every Page is Page One“

Bakers Buch wurde 2013 veröffentlicht, lange vor der aktuellen Welle generativer KI. Seine zentrale Beobachtung war einfach: Leser beginnen nicht immer mit der ersten Seite.

Sie suchen, folgen Links, scannen QR-Codes, öffnen Themen aus Support-Fällen oder gelangen über einen Fehlercode oder eine Komponentennummer an eine Stelle. Die Seite, die sie erreichen, muss als erste Seite funktionieren, denn für diesen Leser und diese Situation ist sie die erste Seite.

Wikipedia bietet einen vertrauten Vergleich. Ein Leser kann auf einen Artikel stoßen, ohne die übergeordnete Struktur der Enzyklopädie zu kennen. Der Artikel liefert genug Kontext, um für sich zu stehen, während Links zu Definitionen, verwandten Konzepten, Details und benachbarten Themen führen. Technische Dokumentation unterliegt strengeren Anwendbarkeits- und Sicherheitsgrenzen, aber die Logik der Einstiegspunkte ist vergleichbar.

Für Baker hat ein brauchbares Thema einen spezifischen Zweck, stellt seinen Kontext her, folgt einem erkennbaren Typ, bleibt auf einer angemessenen Ebene, richtet sich an einen definierten Leser und verlinkt umfassend zu verwandten Informationen.

Für mich ging die Bedeutung über themenbasiertes Schreiben hinaus. Das Buch legte eine andere Form für das Dokumentationssystem selbst nahe: ein vollständiges Handbuch, das nicht jeden Leser durch dieselbe Abfolge zwingt.

Warum das PDF die Idee nur annähern konnte

Zu jener Zeit wurden industrielle Handbücher noch von Seitenzählung, Seitenverweisen, Übersetzungspaketen, Druckanforderungen, Freigabezyklen und der Erwartung geprägt, dass ein Handbuch wie ein vollständiges Buch aussehen sollte.

PDF war ein effizientes Auslieferungsformat, brachte jedoch die Gewohnheiten des Drucks mit sich. Lesezeichen, Hyperlinks, klickbare Diagramme, Übersichtskarten und sorgfältig gestaltete Seitentypen hätten ein PDF navigierbarer machen können. Interaktive PDFs könnten heute Teile dieser Vision annähern; aber auch hier sind kaum welche mehr als digitale Versionen der gedruckten Originale.

PDFs konnten nicht die volle Flexibilität eines Online-Informationsraums bieten. Der Inhalt wäre weiterhin an eine Datei, eine Veröffentlichung und eine Revision gebunden. Noch wichtiger: Der Produktionsumgebung fehlten viele der Voraussetzungen, die für ein wirklich nicht-lineares Handbuch nötig sind:

• wiederverwendbare modulare Inhalte;
• stabile Kennungen für Themen, Komponenten, Konfigurationen und Dokumente;
• definierte Seitentypen;
• Metadaten zu Anwendbarkeit und Zielgruppe;
• aussagekräftige Beziehungen zwischen Themen;
• eine kontrollierte Quelle der Wahrheit;
• Analyse der Änderungsauswirkungen; und
• eine Publishing-Umgebung, die aus einer Inhaltsbasis mehrere Ansichten erzeugen kann.

Das Problem war nicht, dass die Idee unrealistisch war. Das Problem war, dass Dokumentationsabläufe auf die Erstellung eines einzigen freigegebenen Dokuments optimiert waren, nicht auf die Pflege eines navigierbaren Informationsraums.

Was EPPO in der Praxis bedeutet

Die EPPO-Projekte auf AI TechDoc Blog nutzen Bakers Konzept als Grundlage für fiktive Online-Dokumentationsprojekte. EPPO steht für Every Page is Page One.

Ein EPPO-Thema ist nicht einfach ein kurzes Fragment, das aus einem größeren Handbuch herausgeschnitten wurde. Es ist ein bewusst gestaltetes Informationsobjekt mit:

• einem spezifischen Zweck;
• einem erkennbaren Seitentyp;
• einer definierten Zielgruppe und einem definierten Kontext;
• expliziter Anwendbarkeit;
• aussagekräftigen Beziehungen zu benachbarten Themen; und
• einem klaren nächsten Schritt für den Leser.

Ein Aufgabenthema kann angeben, für welche Maschine und Konfiguration es gilt, welche Voraussetzungen erforderlich sind, welcher Betriebsmodus angenommen wird, welche Handlung zulässig ist, welches Ergebnis erwartet wird und was zu tun ist, wenn das Ergebnis nicht eintritt.

Ein Thema zur Störungsbehebung folgt einem anderen Muster. Ein Komponententhema folgt einem anderen. Eine konzeptionelle Einstiegsseite bietet Orientierung innerhalb des Informationsraums. Die Konsistenz der Seitentypen gibt dem Leser Stabilität; die Verknüpfungen zwischen ihnen bieten Tiefe.

EPPO bedeutet daher keine Sammlung unverbundener Kurzseiten. Jede Seite muss sofort nutzbar sein, muss aber auch ihre Beziehungen zu anderen Informationen erklären:

• Lesen Sie dies, bevor Sie die Aufgabe beginnen.
• Dieses Thema gilt für den aktuellen Maschinenzustand.
• Verwenden Sie dieses Verfahren für die vorherige Konfiguration.
• Diese Seite erläutert die Schutzmaßnahme hinter der Anweisung.
• Befolgen Sie diese Wiederanlaufsequenz nach dem Fehler.

Mein erstes Beispiel: eine integrierte Maschinenlinie

Meiner Ansicht nach wird das EPPO-Modell besonders wichtig, wenn mehrere Maschinen zu einer Produktionslinie integriert werden. Die Linie wird nicht angemessen dokumentiert, indem man Lieferantenhandbücher nebeneinanderstellt. Sie hat ihre eigene Betriebslogik, Schnittstellen, Übergabepunkte, Steuerungszustände, Wiederanlaufverfahren und Sicherheitsgrenzen.

Das AI TechDoc EPPO-Projekt liefert eine Momentaufnahme davon, wie Dokumentation anders aussehen könnte. Es verwendet eine fiktive Verpackungslinie mit sechs Maschinen von vier Lieferanten: Einlauf- und Pufferförderer, Abfüll- und Verschließmaschine, Etikettierer, Inspektions- und Ausschleusstation, Kartonpacker und Palettierer mit Stretchwickler.

Ein Leser, der nach einer Linienunterbrechung an der Inspektionsstation steht, muss möglicherweise wissen:

• welcher Zustand sichtbar ist;
• welche Maschinen betroffen sind;
• was die Liniensteuerung anzeigt;
• ob eine Isolierung erforderlich ist;
• welche Rücksetzbedingungen überprüft werden müssen;
• welches Lieferantenverfahren anzuwenden ist; und
• welche Maßnahme zulässig ist, nachdem der sichere Zustand bestätigt wurde.

Eine lineare Sammlung von Handbüchern beantwortet diese Frage auf Linienebene nicht ohne Weiteres. Ein EPPO-Informationsraum kann eine Seite auf Linienebene bereitstellen und sie mit den relevanten Verfahren auf Maschinenebene verknüpfen, wobei die Quell- und Verantwortungsgrenzen erhalten bleiben.

Dasselbe Prinzip gilt für konzeptuelle Landingpages. Eine Dokumentations-Landingpage verkauft kein Produkt. Sie hilft den Lesern zu verstehen, wo sie sich befinden, welche Konfigurationen und Rollen relevant sind und welchem Weg sie als Nächstes folgen sollten.

Was sich im Zeitalter der KI ändert

KI macht die EPPO-Idee sichtbarer und wesentlich leichter umsetzbar, beseitigt aber nicht die Notwendigkeit von Struktur. Sie erhöht den Bedarf an gut durchdachter Struktur.

Ein KI-Assistent kann einem Leser helfen, eine Seite zu finden, eine Beziehung zusammenzufassen oder einen Weg zu leiten, der mit einem Fehlercode oder einer natürlichsprachlichen Frage beginnt. Um dies verantwortungsvoll zu tun, muss er wissen:

• welches Thema die Frage beantwortet;
• für welche Konfiguration das Thema gilt;
• welche Voraussetzungen angenommen werden;
• welche Quelle maßgeblich ist;
• welche verwandten Themen die Grenzen definieren; und
• wann er um Klärung bitten oder eskalieren sollte.

Ohne Seitentypen, Anwendbarkeitsmetadaten, Verantwortlichkeit, Quellbeziehungen und Änderungshistorie kann ein KI-System eine flüssig formulierte Antwort erzeugen, die Informationen aus unvereinbaren Kontexten kombiniert.

KI ersetzt nicht „Every Page is Page One“. Sie macht die Qualität der Seiten, Beziehungen und Grenzen folgenreicher.

Die Idee kam früh – und war nicht unrealistisch

Mark Bakers Buch hat mich angesprochen, weil es Dokumentation aus der Sicht des Lesers und damit des Nutzers beschrieb. Menschen erleben eine Maschine nicht als Kapitelfolge. Sie erleben eine Aufgabe, einen Zustand, eine Frage, eine Unterbrechung, eine Komponente, ein Risiko oder eine Entscheidung.

Das konnte ich lange erkennen, bevor es die Werkzeuge gab, um dies angemessen zu unterstützen. Ich konnte es sogar in der eingeschränkten Form eines PDFs erkennen: eine Orientierungsseite als Karte, Reiter als alternative Einstiegswege und kontrollierte Themen, die durch sinnvolle Links verbunden sind.

Die Idee wurde damals kein funktionierendes Dokumentationssystem, weil die Produktionsmodelle dafür noch nicht bereit waren. Heute haben Online-Dokumentation, integrierte Maschinen, konfigurationsabhängige Informationen und KI-gestützter Zugriff dasselbe gestalterische Problem unmöglich zu ignorieren gemacht.

EPPO bietet eine praktische Richtung: die Dokumentation als Informationsraum aufbauen, jeder Seite einen Zweck und einen Kontext geben, eine kontrollierte Quelle bewahren und mehrere gültige Wege durch sie hindurch erlauben.

Die Idee war nicht zu idealistisch. Sie kam früh.

Aber jetzt ist es höchste Zeit, dass seine Ideen umgesetzt werden, denn das KI-Zeitalter macht sie praktikabel und beherrschbar. Hier ist eine Momentaufnahme dessen, was ich ein EPPO-Projekt für eine integrierte Maschinenlinie nenne: Verpackungsmaschine.