Technische Dokumentation in der Praxis: Der ehrliche Guide für Maschinenbauer und Softwarehersteller

Technische Dokumentation ist das Thema, das in fast jedem Unternehmen existiert und in fast keinem jemanden begeistert. Die Anleitung schreibt der Konstrukteur „nebenbei“, die Online-Hilfe pflegt ein Kollege, der eigentlich Support macht, und die englische Fassung ist auf einem Stand, über den man besser nicht spricht. Das funktioniert erstaunlich lange erstaunlich gut — bis eine Maschine ins Ausland geht, ein Audit ansteht, ein Unfall passiert oder die EU eine neue Verordnung scharf schaltet. Letzteres passiert gerade. Höchste Zeit für einen ehrlichen Überblick: was Technische Dokumentation umfasst, was ab 2027 gilt, welche Werkzeuge wann sinnvoll sind — und warum dein Microsoft-365-Tenant dabei eine größere Rolle spielt, als du denkst.

Warum das Thema jetzt auf die Tagesordnung gehört

Drei Entwicklungen treffen gerade aufeinander. Erstens die Regulatorik: Die neue EU-Maschinenverordnung 2023/1230 löst die alte Maschinenrichtlinie ab und gilt ab Januar 2027 verbindlich — ohne Übergangsgnade. Die für die Praxis spannendste Änderung: Betriebsanleitungen dürfen erstmals digital ausgeliefert werden. Das klingt nach Erleichterung, ist aber vor allem ein Umbauauftrag — denn „PDF per Mail“ ist keine digitale Bereitstellungsstrategie.

Zweitens die Haftung: Die Anleitung ist rechtlich Teil des Produkts. Eine fehlerhafte, unvollständige oder falsch übersetzte Anleitung ist ein Produktfehler — mit allem, was das Produkthaftungsrecht dazu hergibt. Und die Nachweispflicht endet nicht bei der Auslieferung: Die technischen Unterlagen müssen nach dem Inverkehrbringen mindestens zehn Jahre vorgehalten werden. Die Fassung, die 2026 mit der Maschine rausging, muss 2036 noch auffindbar sein — exakt diese Fassung, nicht „irgendeine“.

Drittens die KI: Wer Copilot, Claude und Co. im Unternehmen ernsthaft nutzen will, merkt schnell, dass die Antwortqualität mit der Qualität der Wissensbasis steht und fällt. Strukturierte, metadatenreiche Dokumentation ist das Futter, aus dem brauchbare KI-Antworten entstehen — Word-Gräber sind es nicht. Gute Technische Dokumentation ist damit plötzlich kein Pflichtthema mehr, sondern die Voraussetzung dafür, dass der Service-Mitarbeiter der KI eine Frage zur Maschine stellen kann und eine richtige Antwort bekommt.

Was Technische Dokumentation eigentlich umfasst

„Die Anleitung“ ist nur die Spitze. Technische Dokumentation zerfällt in zwei Welten: die externe Dokumentation, die mit dem Produkt das Haus verlässt, und die interne, die im Haus bleibt, aber existieren und auffindbar sein muss. Beide Welten haben unterschiedliche Anforderungen — und beide werden im Mittelstand gern unterschätzt.

Abb.: Die zwei Welten der Technischen Dokumentation. Links das, was Kunden und Marktaufsicht sehen — rechts das, was bei Audit oder Schadensfall vorgelegt werden muss.

Der Klassiker im Maschinenbau: Die externe Doku bekommt Aufmerksamkeit, weil der Kunde sie sieht. Die interne — allen voran die Risikobeurteilung, aus der die Anleitung eigentlich abgeleitet werden müsste — führt ein Schattendasein. Dabei ist die Reihenfolge fachlich zwingend: Erst die Risikobeurteilung sagt, welche Restrisiken bestehen, dann sagt die Anleitung, wie der Anwender damit umgeht. Wer die Anleitung ohne saubere Risikobeurteilung schreibt, dokumentiert ins Blaue.

Das Grundproblem: das Word-Grab

In den meisten mittelständischen Unternehmen sieht die Realität so aus: Die Doku lebt in Word-Dateien, verteilt über Netzlaufwerke, Mailanhänge und lokale Kopien. Für jedes Maschinenmodell existiert eine eigene Datei, entstanden per „Speichern unter“ aus der Vorgängerversion. Die englische Fassung wurde vor zwei Jahren extern übersetzt und seitdem nicht mehr angefasst, obwohl die deutsche sich dreimal geändert hat. Und welche Fassung genau beim Kunden in Portugal liegt, weiß — niemand.

Abb.: Links der Ist-Zustand mit Kopien-Wildwuchs, rechts das Zielbild Single-Source-Publishing: eine strukturierte Quelle, aus der alle Ausgaben generiert werden.

Das Word-Grab ist kein moralisches Versagen, sondern das natürliche Ergebnis von zwanzig Jahren „hat ja funktioniert“. Teuer wird es an drei Stellen: bei Varianten (jedes Modell eine Kopie, jede Änderung mehrfach einpflegen), bei Übersetzungen (unstrukturierte Dateien lassen sich nicht delta-übersetzen — es wird immer wieder zu viel übersetzt) und bei der Nachweispflicht (welcher Stand ging wann an wen?). Genau diese drei Kostentreiber adressiert strukturiertes Arbeiten.

Topics, Single Source, Wiederverwendung — das Prinzip

Strukturierte Dokumentation beruht auf einer einfachen Idee: Inhalte werden nicht als monolithische Dokumente geschrieben, sondern als eigenständige Bausteine — Topics. Ein Topic beschreibt genau eine Sache: einen Handgriff, ein Konzept, eine Referenztabelle. Aus diesen Bausteinen werden Publikationen zusammengesteckt: die Anleitung für Modell A nimmt 180 Topics, Modell B nimmt 160 davon plus 20 eigene. Die Sicherheitshinweise existieren genau einmal — und sind damit in jeder Publikation identisch und identisch aktuell.

DITA ist der offene Standard, der dieses Prinzip formalisiert: Topic-Typen, Landkarten (Maps), Wiederverwendungsmechanismen, Varianten-Steuerung. Man kann strukturiert arbeiten, ohne DITA zu nutzen — aber DITA ist der Weg, der nicht in einen Hersteller-Lock-in führt. Und nein, dafür braucht es nicht zwingend ein sechsstelliges Redaktionssystem: FrameMaker beherrscht DITA nativ, und für überschaubare Redaktionen reicht das völlig.

Die Werkzeuglandschaft — ehrlich sortiert

Die Werkzeugfrage wird gern ideologisch geführt. Sinnvoller ist ein nüchterner Blick darauf, was welche Klasse leistet und wo die Grenzen liegen:

Die wichtigste Erkenntnis aus dieser Tabelle: Werkzeug und Plattform sind zwei verschiedene Fragen. RoboHelp oder FrameMaker beantworten die Frage „womit schreiben wir?“. SharePoint beantwortet die Frage „wo lebt die Doku, wer findet sie, wie lange bleibt sie nachweisbar?“. Die meisten Werkzeugdiskussionen scheitern daran, dass beide Fragen vermischt werden.

Die M365-Brücke: warum dein Tenant die halbe Miete ist

Hier kommt der Teil, den die klassische Doku-Welt und die Microsoft-Welt gegenseitig übersehen. Die Doku-Szene denkt in Redaktionssystemen und hält SharePoint für eine Dateiablage. Die M365-Berater kennen SharePoint in- und auswendig, haben aber von Betriebsanleitungen und Normenpflicht keine Vorstellung. Dabei liegt die Lösung für den Mittelstand genau in der Mitte: Die Redaktion arbeitet mit ihrem Werkzeug — die Verwaltung, Aufbewahrung, Verteilung und Auffindbarkeit übernimmt der M365-Stack, dessen Lizenzen ohnehin schon bezahlt sind.

Abb.: Arbeitsteilung im M365-Stack: Redaktion produziert, SharePoint verwaltet, Purview sichert die Nachweispflicht, Suche und Copilot machen das Wissen nutzbar.

Konkret heißt das: SharePoint-Bibliotheken mit Inhaltstypen und Metadaten (Maschinentyp, Sprache, Revisionsstand, Gültigkeit) statt Ordner-Wildwuchs. Versionierung und Freigabe-Workflows statt „_final_NEU_2.docx“. Purview-Aufbewahrungsrichtlinien auf Anleitungen und technische Unterlagen — damit die Zehn-Jahres-Pflicht nicht davon abhängt, dass niemand versehentlich aufräumt. Und obendrauf die Suche und Copilot: Ein Service-Techniker, der fragt „Wie tausche ich das Ventil an der Baureihe 400?“, bekommt eine belastbare Antwort — wenn die Doku strukturiert und mit Metadaten versehen ist. Das ist dieselbe Mechanik, mit der Suchmaschinen und KI-Assistenten auch öffentliche Inhalte bewerten: Struktur gewinnt.

KI in der Technischen Redaktion — was geht und was nicht

KI-Assistenten können in der Redaktion echte Arbeit abnehmen: Rohtexte aus Konstruktions-Stichpunkten formulieren, Altbestände klassifizieren und in Topic-Strukturen vorsortieren, Terminologie-Verstöße finden, Übersetzungen vorbereiten. Wer die Werkzeuge klug einsetzt, beschleunigt die Redaktion spürbar — gerade in kleinen Teams, wo die Doku traditionell hinten runterfällt.

Die Grenze verläuft bei der Verantwortung: Sicherheitsrelevante Inhalte — Warnhinweise, Restrisiken, Schutzmaßnahmen — kommen aus der Risikobeurteilung und gehören von fachkundigen Menschen geprüft und freigegeben. Eine KI kann formulieren helfen; die inhaltliche Richtigkeit verantwortet der Hersteller, und zwar vollständig. Dasselbe gilt für maschinelle Übersetzung: hervorragend als Vorstufe mit fachlichem Post-Editing, fahrlässig als ungeprüfter Direktversand.

Sonderfall KI-generierte Bilder

Ein Kapitel für sich — und eines, das gerade richtig Fahrt aufnimmt — sind KI-generierte Illustrationen. Die klare Trennlinie: Konzeptgrafiken, Prinzipdarstellungen, Schulungsillustrationen und Titelbilder funktionieren hervorragend, schneller und günstiger als jede Stock-Recherche oder Grafikbeauftragung. Tabu sind dagegen Darstellungen, die das reale Produkt exakt zeigen müssen — Explosionszeichnungen, Bedienpanels, Ersatzteilansichten — sowie genormte Warnsymbole: Die KI erfindet im Zweifel Bauteile, die es nicht gibt, und ein „fast richtiges“ Sicherheitszeichen nach ISO 7010 ist schlimmer als gar keins. In einer Betriebsanleitung ist das kein Stilproblem, sondern ein Haftungsproblem.

Richtig eingesetzt senkt KI-Bildgenerierung sogar die Übersetzungskosten: Wer Illustrationen von vornherein textfrei generiert und Beschriftungen als nummerierte Legende im Fließtext führt, muss bei zehn Zielsprachen nur noch Text übersetzen statt zehnmal Grafiken nachzubauen. Wie professionelle Bildgenerierung funktioniert — von den Werkzeugen und Workflows über Bildrechte bis zu Compliance und Governance im Unternehmen — ist auf boddenberg.de ein eigener Kompetenzbereich: KI-Bildgenerierung. Die Schnittstelle zur Technischen Dokumentation wird dort wie hier weiter ausgebaut.

Mehrsprachigkeit — der unterschätzte Kostenblock

Sobald Produkte die Sprachgrenze überqueren, wird die Übersetzung zum größten laufenden Kostenblock der Doku — und zum besten Hebel. Die Stellschrauben: strukturierte Quellen (delta-fähig übersetzen statt Volltext), Translation Memory und Termbasis (Wiederholungen werden günstiger), maschinelle Vorübersetzung mit Post-Editing, und textfreie Grafiken mit Legenden statt beschrifteter Bilder. Wie das konkret mit RoboHelp aussieht — vom manuellen Workflow bis zur vollautomatischen Pipeline —, steht im ausführlichen Fachartikel zur Mehrsprachigkeit mit RoboHelp.

Fazit: Pflichtthema mit eingebautem Termindruck

Technische Dokumentation ist 2026 kein Thema mehr, das man weiter aussitzen kann: Die Maschinenverordnung setzt eine harte Frist, die Haftungslage war nie entspannt, und die KI-Welle belohnt ausgerechnet die, die ihre Doku strukturiert im Griff haben. Die gute Nachricht: Der Weg vom Word-Grab zur belastbaren Doku-Landschaft ist kein Mammutprojekt — er ist eine Abfolge überschaubarer Schritte, und die Plattform dafür liegt in Form des M365-Tenants meist schon im Haus. Was du nicht machen solltest: bis Dezember 2026 warten und dann hektisch werden. Genau das werden viele tun — sei schlauer.

Häufige Fragen zur Technischen Dokumentation

Was gehört alles zur Technischen Dokumentation einer Maschine?

Zwei Welten: die externe Dokumentation, die mit dem Produkt ausgeliefert wird — Betriebs- und Montageanleitung, Service- und Wartungsunterlagen, Konformitätserklärung, Kennzeichnung — und die interne Dokumentation, die im Haus bleibt, aber vorgehalten werden muss: Risikobeurteilung, technische Unterlagen mit Konstruktions- und Prüfnachweisen, Normen-Dokumentation. Die Anleitung ist dabei rechtlich Teil des Produkts, nicht bloß eine Beigabe.

Was ändert sich mit der EU-Maschinenverordnung ab 2027?

Die Verordnung (EU) 2023/1230 ersetzt die Maschinenrichtlinie und gilt ab Januar 2027 unmittelbar in allen Mitgliedstaaten. Für die Dokumentation am wichtigsten: Betriebsanleitungen dürfen erstmals digital bereitgestellt werden, dazu kommen angepasste Anforderungen unter anderem für Software und selbstlernende Systeme. Wer Maschinen baut, sollte 2026 nutzen, um Doku-Bestand und Prozesse auf die neuen Anforderungen zu prüfen — ab dem Stichtag gibt es keine Übergangsfrist.

Dürfen Betriebsanleitungen künftig nur noch digital ausgeliefert werden?

Digital wird zulässig, aber nicht bedingungslos: Der Käufer kann beim Kauf eine kostenlose Papierfassung verlangen, und die digitale Anleitung muss über die Lebensdauer der Maschine verfügbar bleiben — ein toter Link erfüllt die Pflicht nicht. Praktisch heißt das: Es braucht eine dauerhafte, versionierte Bereitstellung, nicht nur ein PDF im Mailanhang.

Wie lange müssen technische Unterlagen aufbewahrt werden?

Mindestens zehn Jahre nach dem Inverkehrbringen der Maschine — und zwar in der jeweils gültigen Fassung, auffindbar und nachweisbar unverändert. Ein Backup ist dafür kein Nachweis. In Microsoft-Umgebungen lösen das Aufbewahrungsrichtlinien und -label in Purview, die Manipulation und versehentliches Löschen technisch unterbinden.

Lohnt sich DITA für ein mittelständisches Unternehmen?

Als Faustregel: ja, wenn mindestens zwei von drei Faktoren zutreffen — über etwa 300 Seiten Doku-Bestand, mehr als drei Produktvarianten, mehr als zwei Zielsprachen. Darunter fährt man mit diszipliniertem Word oder einem Werkzeug wie RoboHelp oft ehrlicher. Und DITA heißt nicht automatisch teures Redaktionssystem: FrameMaker beherrscht DITA nativ, für überschaubare Redaktionen reicht das.

Können wir unsere Doku einfach in Word weiterführen?

Für kleine Bestände mit wenigen Varianten und ein bis zwei Sprachen: ja — sofern mit Formatvorlagen-Disziplin gearbeitet wird und die Verwaltung sauber läuft, etwa in SharePoint mit Versionierung und Metadaten statt auf Netzlaufwerken. Die Grenze ist erreicht, wenn Varianten per Kopie entstehen oder die Übersetzungsrechnungen steigen: Beides sind Symptome dafür, dass die Struktur fehlt, nicht der Fleiß.

Was bringt SharePoint für die Technische Dokumentation?

SharePoint ersetzt kein Redaktionswerkzeug, löst aber die Verwaltungsfrage: Bibliotheken mit Inhaltstypen und Metadaten statt Ordnerchaos, Versionierung und Freigabe-Workflows statt Dateinamens-Akrobatik, Purview-Aufbewahrung für die Nachweispflicht und eine Suche, die Service und Vertrieb wirklich nutzen können. Der entscheidende Punkt für den Mittelstand: Die Lizenzen dafür sind mit Microsoft 365 meist schon bezahlt — es fehlt nur das Konzept.

Kann KI unsere Anleitungen schreiben?

KI kann formulieren, strukturieren, Altbestände vorsortieren und Übersetzungen vorbereiten — das spart real Zeit. Die Verantwortung bleibt aber vollständig beim Hersteller: Sicherheitsrelevante Inhalte kommen aus der Risikobeurteilung und gehören fachkundig geprüft und freigegeben, maschinelle Übersetzungen von Warnhinweisen brauchen Post-Editing. KI ist ein starkes Redaktionswerkzeug, kein Freibrief.

Was kostet die Erstellung einer Betriebsanleitung?

Eine seriöse Pauschale gibt es nicht — die Spanne hängt an Maschinenkomplexität, Qualität der Risikobeurteilung, Varianten- und Sprachenzahl und daran, wie viel verwertbarer Bestand existiert. Die ehrliche Antwort ist eine Bestandsaufnahme mit anschließender Aufwandsschätzung. Sicher ist nur eines: Die teuerste Anleitung ist die fehlerhafte — Produkthaftungsfälle kosten mehr als jede Redaktion.

Wer haftet bei Fehlern in der Anleitung?

Der Hersteller — die Anleitung ist Teil des Produkts, ein Instruktionsfehler ist ein Produktfehler. Das gilt auch für Übersetzungsfehler in ausgelieferten Sprachfassungen. Deshalb gehören sicherheitsrelevante Texte durch fachkundige Prüfung und dokumentierte Freigaben abgesichert — und deshalb ist die lückenlose Aufbewahrung der ausgelieferten Stände keine Bürokratie, sondern die eigene Verteidigungslinie.