Technische Dokumentation als Register statt Dateiarchiv: was 114 Technologiekarten gezeigt haben

Technische Dokumentation veraltet selten auf einmal, sondern Datei für Datei: Eine Anleitung wird kopiert, geändert und unter neuem Namen abgelegt, bis niemand mehr sicher sagen kann, welche Fassung gilt. Die Antwort ist ein Register statt eines Ordners – jede Änderung als neue Version, mit einer verantwortlichen Person und dem Nachweis, wer danach geschult wurde.

Wo technische Dokumentation im Dateiarchiv verloren geht

Bei einem Hersteller technischer Produkte liegt das Wissen nach der Auslieferung selten an einer Stelle. Wartungsanleitungen stehen als PDF auf einem Laufwerk, Einstellwerte in einer Tabelle, Ergänzungen in E-Mails an den Außendienst. Jede dieser Dateien kann für sich richtig sein. Schwierig wird es bei Fragen, die mehrere Dateien zugleich betreffen: Welche Fassung galt, als die Anlage beim Kunden zuletzt gewartet wurde? Wer hat die letzte Änderung freigegeben? Kennt der Techniker, der morgen hinausfährt, den aktuellen Stand?

Ein Dateisystem beantwortet keine davon. Es kennt Dateinamen und Änderungsdaten, aber weder Zuständigkeiten noch Schulungsstände. Aus einer Frage an die Unterlagen wird so eine Frage an Menschen, und die Antwort hängt davon ab, wer gerade im Haus ist. Das fällt im Alltag lange nicht auf, weil erfahrene Leute die Lücke mit ihrem Gedächtnis schließen. Es fällt auf, wenn genau diese Leute im Urlaub sind oder das Unternehmen verlassen.

Das Beispiel: 114 Technologiekarten aus dem Archiv

Das Muster haben wir nicht an einer Maschine kennengelernt, sondern an Rezepturen. Bei einer Unternehmensgruppe aus Lebensmittelproduktion und Filialhandel lagen die Technologiekarten der Produktion – die Rezepturen, nach denen gearbeitet wird – in einem Dateiarchiv. Drei Folgen waren im Betrieb spürbar: Selbstkosten ließen sich auf dieser Grundlage nicht rechnen, niemand wusste verlässlich, wer nach welcher Karte geschult war, und Änderungen gingen auf dem Weg zwischen Kopien verloren.

Heute werden 114 Karten als Register in der Datenbank geführt. Jede Karte trägt ihre Historie, die Personen, die für sie verantwortlich sind, und die Mitarbeiter, die auf sie geschult wurden. Das klingt nach Verwaltung, verändert aber die Art der Fragen: Statt „Wer hat die aktuelle Datei?“ lautet sie „Was steht in der geltenden Version, und wer kennt sie?“ – und darauf gibt eine Abfrage Antwort, nicht ein Rundruf.

Drei Regeln, die ein Register vom Ordner unterscheiden

1. Versionen werden angehängt, nie überschrieben. Jede Änderung erzeugt einen neuen Stand, der alte bleibt lesbar. In diesem Register ist bis heute keine Version überschrieben worden. Damit lässt sich jede frühere Fassung zeigen, ohne dass jemand an eine Sicherungskopie gedacht haben muss.
2. Zuständigkeit ist ein Feld, kein Wissen im Kopf. Wer für eine Karte verantwortlich ist und wer auf sie geschult wurde, steht an der Karte selbst. Scheidet jemand aus oder wechselt die Abteilung, ist die Lücke sichtbar, bevor sie im Betrieb auffällt.
3. Das Sprachmodell schlägt vor, ein Mensch bestätigt. Änderungen können mit KI vorbereitet werden. Übernommen wird ein Vorschlag erst nach menschlicher Bestätigung, und die bestätigte Fassung wird automatisch mit der internen Wissensbasis abgeglichen. So beantwortet ein Assistent später Fragen aus dem Stand, der wirklich gilt, und nicht aus einem Entwurf.

Eine Grenze gehört dazu: Ein Register prüft keine Inhalte. Steht in einer Karte ein falscher Wert, steht er auch nach der Übernahme darin – nur jetzt mit Datum und Verantwortlichem. Die fachliche Prüfung bleibt Aufgabe der Leute, die das Produkt kennen. Das Register sorgt dafür, dass ihre Korrektur nicht wieder in einer Kopie verschwindet.

Was das für die technische Dokumentation eines Herstellers heißt

Eine Technologiekarte aus der Produktion und eine Wartungsanleitung für eine Anlage haben dieselbe Form: ein Dokument, das sich ändert, eine Person, die dafür geradesteht, und Menschen, die danach arbeiten. Die Datenstruktur des Registers passt deshalb auf beide.

Für einen Hersteller kommt eine Ebene hinzu, die in der Konditorei eine kleinere Rolle spielt: der Geltungsbereich. Eine Anleitung gilt oft nicht für alle ausgelieferten Geräte, sondern für eine Baureihe oder einen Seriennummernbereich. Im Register wird aus „Version“ dann „Version und Geltungsbereich“ – eine zusätzliche Spalte, kein anderes System. Wie Wartungsintervalle und Serviceeinsätze an solche Unterlagen anschließen, beschreibt der Lexikonartikel zum Wartungsmanagement.

Wie wir ein solches Register aufsetzen

Wir beginnen nicht mit der Oberfläche, sondern mit einem Ausschnitt des Archivs, etwa den Unterlagen einer Produktlinie. Gemeinsam mit den Leuten, die damit arbeiten, legen wir fest, was als neue Version gilt, wer freigibt und welche Schulungsnachweise gebraucht werden. Diese Punkte stehen als Abnahmekriterien im Angebot, bevor die erste Zeile Code entsteht.

Gebaut wird in Teillieferungen auf TypeScript, Nuxt und PostgreSQL; jede Lieferung ist für sich prüfbar. Soll ein Sprachmodell Änderungen vorbereiten oder Fragen aus den Unterlagen beantworten, halten wir im Angebot fest, welche Dokumente es zu sehen bekommt. Wie wir solche Vorhaben vertraglich fassen, steht auf der Seite Softwareentwicklung.