Eine Technische Dokumentation (auch Technische Kommunikation, Technikdokumentation oder Produktdokumentation) umfasst alle Informationsprodukte, die ein technisches Erzeugnis beschreiben und zu seiner Nutzung, Wartung oder Reparatur anleiten. Sie bereitet die Informationen systematisch auf und strukturiert sie so, dass der jeweilige Zweck vollständig erfüllt wird. Die Technische Dokumentation wird dem dokumentierten Erzeugnis meist über Namens- und Nummernsysteme eindeutig zugeordnet. In Deutschland und im deutschsprachigen Raum ist die Gesellschaft für Technische Kommunikation e. V. (Tekom) federführend für die Weiterentwicklung des Berufsbilds von Technischen Redakteuren und der Technische Kommunikation bzw. Technische Dokumentation.
Zweck Die Technische Dokumentation dient der Information und Instruktion in der Regel definierter Zielgruppen, der haftungsrechtlichen Absicherung des Herstellers, der Produktbeobachtung, der Rückverfolgbarkeit und Reproduzierbarkeit sowie der dauerhaften bzw. gesetzlich geforderten Archivierung der relevanten Informationsinhalte.
Die Bestandteile der Technischen Dokumentation bieten Informationen über das Produkt selbst, den Umgang mit ihm und über das Verhalten der Nutzer. Sie betrachten alle Lebensphasen des Produktes, von der Entwicklung bis zur Entsorgung, teilweise einschließlich der Herstellung der Vorprodukte.
Begriffsdefinition: Technische Dokumentation vs. Technische Kommunikation vs. Technische Redaktion vs. Informationsentwicklung
Technische Dokumentation Technische Dokumentation bezeichnet schriftliche oder elektronische Materialien, die technische Informationen über ein Produkt, eine Anwendung oder einen Prozess vermitteln. Technische Dokumentation kann Handbücher, Bedienungsanleitungen, Installationsanleitungen, Wartungsanleitungen, technische Zeichnungen und andere Arten von Dokumenten umfassen. Der Schwerpunkt liegt hier auf der Bereitstellung präziser und verständlicher technischer Informationen.
Technische Kommunikation Technische Kommunikation ist ein breiterer Begriff, der die Kommunikation von technischen Informationen in verschiedenen Formen und Medien abdeckt. Dies kann schriftliche Dokumentation, visuelle Elemente wie Diagramme und Illustrationen, Online-Hilfen, Videos und vieles mehr umfassen. Die Technische Kommunikation zielt darauf ab, komplexe technische Konzepte und Informationen für ein breites Publikum verständlich zu machen.
Technische Redaktion Die Technische Redaktion umfasst den Prozess der Erstellung, Bearbeitung und Pflege von technischen Dokumentationen und anderen Informationsmaterialien. Technische Redakteure sind für die Umsetzung von technischen Inhalten in klare und verständliche Dokumente verantwortlich. Technische Redakteure können an der Planung, Erstellung und Überarbeitung von technischen Inhalten beteiligt sein.
Informationsentwicklung Informationsentwicklung betont den Aspekt der Entwicklung von Informationen in einem breiteren Kontext. Informationsentwicklung kann die Erstellung von technischer Dokumentation, aber auch die Gestaltung von Schulungsmaterialien, Online-Hilfen, Benutzeroberflächen und anderen Formen von Informationsprodukten umfassen. Es bezieht sich auf den gesamten Prozess, wie Informationen entwickelt, strukturiert und präsentiert werden, um den Nutzern zu helfen.
Die Verwendung der Bezeichnungen kann in verschiedenen Ländern und Branchen variieren. Eine universelle Definition gibt es nicht und die Bedeutung entwickelt sich im Kontext einer bestimmten Organisation oder Branche. In der Praxis kann eine Organisation ihre eigenen Bezeichnungen und Standards für diese Begriffe festlegen.
Für spezifische Informationen und Stellungnahmen zu diesen Begriffen in Ihrem Kontext oder Ihrer Branche empfiehlt es sich, die offiziellen Richtlinien und Veröffentlichungen von relevanten Organisationen, wie der tekom (Gesellschaft für Technische Kommunikation und Informationsentwicklung e. V.) in Deutschland, oder vergleichbaren Organisationen in Ihrer Region zu konsultieren. Diese Organisationen setzen oft Standards und bewahren bewährte Praktiken in Bezug auf die technische Kommunikation und Dokumentation.
Interne und externe Technische Dokumentation Bei der Technischen Dokumentation wird nach VDI 4500 zwischen interner und externer Technischer Dokumentation unterschieden:
Interne technische Dokumentation Die interne Technische Dokumentation dient der internen Archivierung aller produktrelevanten Dokumente und der Nachweispflicht, alle rechtlichen Pflichten eingehalten zu haben. Sie umfasst den gesamten Produktlebenszyklus von der Produktplanung über Entwicklung, Markteinführung und Produktbeobachtung bis zur Einstellung des Produkts.
Die Informationen bleiben im Normalfall beim Hersteller, der sie dauerhaft archiviert und während der gesamten Lebensdauer des Produkts aktuell hält. Typische Bestandteile sind Pflichtenhefte, Berechnungsunterlagen, Versuchsberichte, Risikobeurteilungen, technische Zeichnungen und Fertigungsunterlagen, Nachweise über Maßnahmen der Qualitätssicherung sowie die gesamte externe Technische Dokumentation des Produkts. Der Hersteller muss die Dokumente der internen Technischen Dokumentation auch nach dem Inverkehrbringen des Produktes für behördliche Nachfragen aufbewahren. Die Aufbewahrungspflichten des Herstellers sind unterschiedlich geregelt. In der Richtlinie 2006/42/EG (Maschinenrichtlinie) wird, in ANHANG VII, gefordert: „2. Die in Nummer 1 genannten technischen Unterlagen sind für die zuständigen Behörden der Mitgliedstaaten nach dem Tag der Herstellung der Maschine — bzw. bei Serienfertigung nach dem Tag der Fertigstellung der letzten Einheit — mindestens zehn Jahre lang bereitzuhalten.“
Die interne Dokumentation der Fertigungsunterlagen wird in der Regel von der Entwicklungs- oder Konstruktionsabteilung des Herstellers geführt. Die Dokumente der Zulieferteile werden meist in einem Dokumentenmanagementsystem gespeichert.
Externe technische Dokumentation Die externe Technische Dokumentation dient der Information der Betreiber und Benutzer des Produkts und stellt sicher, dass das Produkt sicher und bestimmungsgemäß in Betrieb genommen, verwendet, gewartet und ggf. entsorgt werden kann.
Die externe Dokumentation wird in der Regel von Technischen Redakteuren erstellt und in der Regel in die Sprache der jeweiligen Anwender übersetzt. Je nach Produkt, Zielgruppe und gesetzlichen Anforderungen sind verschiedene Bezeichnungen und Formen möglich, wie Gebrauchsanleitung, Installationsanleitung, Montageanleitung, Kurzanleitung, Benutzerhandbuch, Gebrauchsanweisung, Bordbuch, Serviceanleitung, Online-Hilfe, Tutorial usw.
Spezielle Unterarten der Technischen Dokumentation ergeben sich aus rechtlichen Anforderungen wie der Hinterlegungspflicht bei Benannten Stellen (Beispiel: Technische Dokumentation nach Richtlinie 2014/34/EU „ATEX“).
Gesetzliche Grundlagen Um die Sicherheit von Produkten sicherzustellen, fordern staatliche Gesetze und Vorschriften privatrechtlicher Organisationen die Hersteller und Einrichter von technischen Erzeugnissen zur Bereitstellung der Technischen Dokumentation.
In der EU sind einschlägige EG-Richtlinien wie die Maschinenrichtlinie, die ATEX-Richtlinie, die Niederspannungsrichtlinie, die Druckgeräterichtlinie oder die Produktsicherheitsrichtlinie zu nennen, die von den Mitgliedstaaten in nationales Recht umgesetzt wurden (z. B. deutsches Produktsicherheitsgesetz oder Medizinproduktegesetz).
Im Schadensfall führt eine fehlerhafte Technische Dokumentation zur Haftung des Herstellers, die sich aus dem Produkthaftungsgesetz (in Deutschland), dem Bürgerlichen Gesetzbuch (§ 823 Schadensersatzpflicht) sowie eventuellen einzelvertraglichen Verpflichtungen ergibt.
Normen Normen und Richtlinien erstellen das DIN, der VDE, der VDI und das CEN. Im englischen Sprachgebrauch wird zwischen Normen und Standards nicht unterschieden. Internationale Standards erstellt und liefert unter anderem die ISO (die bei den Vereinten Nationen als weltweit koordinierende Standardisierungsinstitution registriert ist). Standards nationaler Organisationen wie die amerikanische ANSI oder das russische GOST finden ebenso internationale Anerkennung. Weitere Standardisierungsgremien finden sich beispielsweise in der IEC, der IMO, der IATA und der ICAO, die ihre Arbeit teilweise direkt mit der ISO organisieren und koordinieren.
Leitfäden für das Gestalten von Technischer Dokumentation oder Benutzerinformation sind in Form verschiedener Normen und Richtlinien verfügbar, die EN 82079 oder die Richtlinie VDI 4500. Die Dokumentation für Kraftwerke ist geregelt in der VGB-Richtlinie VGB-S-831-00, Lieferung der Technischen Dokumentation (Technische Anlagendaten, Dokumente) für Anlagen der Energieversorgung.
Die EN 61355 regelt die Klassifikation und Kennzeichnung von Dokumenten der Technischen Dokumentation für Anlagen, Systeme und Einrichtungen. Als Anwendungsbereich der Norm ist die gesamte technische Dokumentation im Lebenszyklus technischer Produkte, einschließlich der nichttechnischen Dokumente aus dem Engineeringprozess vorgesehen.
In einigen Industriebereichen werden abhängig von der zivilen oder militärischen Nutzung eines Produktes unterschiedliche Normen, Richtlinien und Spezifikationen eingesetzt. In der Luftfahrt sind dies beispielsweise die Spezifikation ATA100/ATA2000 im zivilen Bereich und die Spezifikation S1000D in der Wehrtechnik, wobei auch zivile Normen für Wehrmaterial verwendet werden und umgekehrt. Die Rangfolge der Normen, Richtlinie (EU) und Spezifikationen, für Wehrmaterial sind in § 14 der RICHTLINIE 2009/81/EG sowie in der DIN EN 16341 geregelt. Die Spezifikation DIN SPEC 3105 sammelt Anforderungen an die technischen Dokumentation von Open-Source-Hardware.
Für die physische Verwaltung der schriftlichen und elektronischen Dokumente kommt die internationale Norm ISO 15489 (Records Management/Schriftgutverwaltung) zur Anwendung.
Terminologie (Begrifflichkeiten) der technischen Produktdokumentation regelt u. a. DIN 199.
Dokumentationssystematik Das Arbeiten an einer Dokumentation ist eine planbare Tätigkeit. Die interne und externe Technische Dokumentation sind integraler Bestandteil der Produktentwicklung im Produktlebenszyklus. Daher sollte eine systematische Produktion auch technischer Dokumentation einem Plan folgen, der wiederum während der Bearbeitung erweitert und verändert wird.
Struktur Die Technische Dokumentation muss logisch gegliedert und strukturiert sein. Um die Handhabung zu erleichtern, werden bestimmte Dokumente in Gruppen thematisch oder analog zur Struktur des Erzeugnisses zusammengefasst und mit modular aufgebauten Dokumentenlisten und Inhaltsverzeichnissen verwaltet. Zum Zweck der Rückverfolgbarkeit von Revisionsständen ist eine Änderungshistorie üblich. Einen plastischen Überblick über die Dokumentationssystematik geben Normen wie die DIN 6789.
Eine bestimmte Struktur unterstützt eine ausgewählte Sicht auf einen Bestand an Dokumentation. Daher kann diese Struktur nicht allen Anforderungen gleichzeitig in demselben Maße genügen. Zwischen einer speziellen Struktur und möglichen weiteren speziellen Interessen einer anderen Ordnung vermittelt ein Index.
Strukturierungsmethoden Insbesondere die Benutzerinformation stellt hohe Anforderungen hinsichtlich Übersichtlichkeit und Verständlichkeit. Um die oft komplexen Informationen übersichtlich zu gliedern und leicht verständlich darzustellen, gibt es Strukturierungsmethoden, wie die Information-Mapping-Technik oder das Funktionsdesign. Diese erleichtern die Aufnehmbarkeit der Inhalte und ermöglichen dem Benutzer der Dokumente ein leichteres Auffinden der gesuchten Information. Eine Strukturierung unterstützt außerdem die Erstellung, Verwaltung, Wiederverwendung und Publikation von Inhalten mit einem Redaktionssystem.
Verwendung von Farben und Kontrasten in Sicherheits- und Warnhinweisen