Search and Find
Service
More of the content
Grundlagen der Technischen Dokumentation - Anleitungen verständlich und normgerecht erstellen
Inhalt
5
Kapitel 1
13
Grundlegendes
13
1.1 Stellenwert der Technischen Dokumentation
13
1.2 Arten von Technischer Dokumentation
14
1.3 Berufsbild des Technischen Redakteurs
15
Kapitel 2
17
Gesetze, Richtlinien und Normen
17
2.1 Grundlagen der CE-Kennzeichnung
17
2.1.1 Die Europäische Union
18
2.1.2 Gesetzgebungsverfahren in der EU
19
2.1.3 EG-Richtlinien nach „Neuer Konzeption“ (New Approach)
19
2.1.4 Marktaufsicht
21
2.1.5 Geltungsbereich der EG-Richtlinien
22
2.2 Geräteund Produktsicherheitsgesetz und EG-Richtlinien
23
2.2.1 Geräteund Produktsicherheitsgesetz (GPSG)
23
2.2.2 Maschinenrichtlinie
24
2.2.3 Niederspannungsrichtlinie
26
2.2.4 EMV-Richtlinie
26
2.2.5 Geräte in explosionsgefährdeten Bereichen (ATEX)
27
2.2.6 Medizinprodukterichtlinie
28
2.2.7 Weitere Richtlinien
29
2.3 Produkthaftung
30
2.4 Normen
31
2.4.1 Grundlagen der Normung
31
2.4.2 DIN EN 62079
34
2.4.3 DIN EN ISO 12100-2
38
2.4.4 ISO Guide 37
40
2.4.5 VDI 4500
42
2.4.6 DIN-Fachbericht 146
45
2.4.7 DIN EN 15038
47
2.5 Formale Anforderungen an die Anleitung
49
2.5.1 Vollständigkeit
49
2.5.2 Verständlichkeit
49
2.5.3 Lieferform
50
2.5.4 Zeitpunkt der Bereitstellung
50
2.5.5 Sprache
51
2.5.6 Muss der Nutzer die Anleitung eigentlich lesen?
51
2.6 Spezielle Anforderungen an Softwaredokumentation
52
2.6.1 Internationale Normen
52
2.6.2 Software als Bestandteil eines Produkts oder Geräts
52
2.6.3 Anwendbarkeit des Geräteund Produktsicherheitsgesetzes (GPSG)
53
2.6.4 Mängelgewährleistung
53
2.6.5 Sicherheitsanforderungen und abgeleitete Pflichten
53
2.6.6 Sprachen
55
2.7 Die Risikobeurteilung – Grundlage der Betriebsanleitung
55
Kapitel 3
59
Dokumentationsprozess
59
3.1 Projektplanung
59
3.1.1 Zuständigkeiten
60
3.2 Zielgruppenanalyse
60
3.2.1 Zielgruppensegmentierung
61
3.2.2 Zielgruppencharakterisierung
62
3.3 Recherche
63
3.3.1 Recherchecheckliste erstellen
63
3.3.2 Vorhandene Informationen auswerten
65
3.3.3 Recherche vorbereiten
66
3.3.4 Recherche durchführen
66
3.3.5 Recherche auswerten
67
3.4 Erstellung
68
3.4.1 Erstellungsprozess
68
3.4.2 Tipps für optimale Arbeitsabläufe beim Erstellungsprozess
68
3.5 Qualitätssicherung
70
3.5.1 Welche Faktoren bestimmen die Qualität von Technischen Dokumentationen?
71
3.5.2 Durch welche Prozesse und Systeme kann die Qualität sichergestellt werden?
72
3.6 Übersetzung
75
3.7 Stolpersteine
76
3.8 Prozesse optimieren
77
Kapitel 4
79
Inhalte der Anleitung
79
4.1 Deckblatt
79
4.2 Impressum
81
4.3 Inhaltsverzeichnis
81
4.4 Allgemeines
81
4.4.1 Informationen zu dieser Anleitung
82
4.4.2 Symbolerklärung
82
4.4.3 Haftungsbeschränkung*
83
4.4.4 Urheberschutz
84
4.4.5 Garantie und Gewährleistung
84
4.5 Sicherheit
85
4.5.1 Bestimmungsgemäße Verwendung
86
4.5.2 Allgemeine Gefahrenquellen
86
4.5.3 Verantwortung des Betreibers*
88
4.5.4 Personalqualifikation
89
4.5.5 Sicherheitskennzeichnung
90
4.5.6 Schutzausrüstung
91
4.5.7 Sicherheitseinrichtungen
92
4.5.8 Sichern gegen Wiedereinschalten
94
4.5.9 Verhalten im Gefahrenfall
94
4.5.10 Umweltschutz
95
4.6 Technische Daten
95
4.6.1 Darstellung der Technischen Daten*
96
4.6.2 Technische Daten im Einzelnen
96
4.6.3 Alternative Darreichungsformen
98
4.7 Aufbau und Funktion
99
4.7.1 Kurzbeschreibung*
99
4.7.2 Übersicht
99
4.7.3 Lieferumfang*
102
4.7.4 Prozessoder Funktionsbeschreibung
102
4.7.5 Beschreibung der Baugruppen*
103
4.7.6 Anschlüsse
104
4.7.7 Anzeigen und Bedienelemente
105
4.7.8 Bediensoftware
106
4.7.9 Arbeitsplätze und Gefahrenbereiche
107
4.7.10 Betriebsarten
108
4.7.11 Zubehör, Werkzeuge
109
4.8 Transport
109
4.8.1 Sicherheit
109
4.8.2 Transportinspektion*
110
4.8.3 Symbole auf der Verpackung*
111
4.8.4 Verpackung
111
4.8.5 Transport
113
4.8.6 Lagerung
114
4.9 Installation und Erstinbetriebnahme
114
4.9.1 Sicherheit
117
4.9.2 Anforderungen an den Aufstellort
117
4.9.3 Vorbereitungen
118
4.9.4 Installation
118
4.9.5 Anschließen
119
4.9.6 Erstinbetriebnahme
120
4.10 Bedienung, Betrieb
120
4.10.1 Sicherheit
121
4.10.2 Tätigkeiten vor Gebrauch
121
4.10.3 Einund Ausschalten
122
4.10.4 Normalbetrieb
123
4.10.5 Besondere Handlungen
123
4.10.6 Tätigkeiten nach der Benutzung
124
4.10.7 Reinigung, Desinfektion, Sterilisation
124
4.11 Wartung
124
4.11.1 Sicherheit
125
4.11.2 Wartungsplan
125
4.11.3 Wartungsarbeiten
127
4.12 Störungen
128
4.12.1 Sicherheit
129
4.12.2 Störungsanzeigen
129
4.12.3 Verhalten bei Störungen
130
4.12.4 Störungstabelle
131
4.12.5 Arbeiten zur Störungsbeseitigung
133
4.13 Demontage, Entsorgung
133
4.13.1 Sicherheit
133
4.13.2 Demontage
134
4.13.3 Entsorgung
134
4.14 Glossar
135
4.15 Index
135
4.16 Anhang
138
4.16.1 Konformitätserklärung
139
4.16.2 Qualitätsdokumentation
139
4.16.3 Datenblätter
140
4.16.4 Checklisten, Prüfbücher
140
4.16.5 Anleitungen der Lieferanten
140
Kapitel 5
142
Anleitungen formulieren
142
5.1 Verständlich formulieren
142
5.1.1 Kurze und einfache Sätze formulieren
143
5.1.2 Substantivierungen vermeiden
143
5.1.3 Sätze nicht über Aufzählungen fortsetzen
143
5.1.4 Klemmkonstruktionen vermeiden
144
5.1.5 Funktionsverbgefüge vermeiden
144
5.2 Präzise formulieren
145
5.2.1 Eindeutige Terminologie
145
5.2.2 Abstrakte Begriffe und Fremdwörter vermeiden
145
5.2.3 Einzelheiten direkt benennen
146
5.2.4 Abkürzungen vermeiden
146
5.2.5 Firmenjargon vermeiden
146
5.2.6 Füllwörter vermeiden
147
5.2.7 Weichmacher vermeiden
147
5.3 Einheitlich formulieren
148
5.3.1 Einheitliche Anrede
148
5.3.2 Einheiten und Werte
149
5.3.3 Komposita übersichtlich schreiben
149
5.4 Überschriften korrekt wählen
150
5.5 Textwüsten vermeiden, Texte strukturieren
150
5.6 Handlungsanweisungen formulieren
151
5.6.1 Handlungsanweisung betiteln
151
5.6.2 Voraussetzungen definieren
151
5.6.3 Handlungsschritte typografisch hervorheben
154
5.6.4 Handlungsschritte aktivisch formulieren
155
5.6.5 Handlungsschritte vollständig formulieren
155
5.6.6 Eine Handlung je Handlungsschritt
156
5.6.7 Richtige Reihenfolge einhalten
157
5.6.8 Beispiel für eine gute Handlungsanweisung
157
5.7 Querverweise setzen
157
5.8 Übersetzungsgerecht schreiben
161
Kapitel 6
162
Anleitungen gestalten
162
6.1 Funktionsund zielgruppengerechte Gestaltung
162
6.1.1 Zweck der Gestaltung
162
6.1.2 Einfluss der Zielgruppe
163
6.1.3 Einfluss des Produktes
165
6.1.4 Entwicklung einer zweckgerichteten Gestaltung
166
6.2 Seitengestaltung
169
6.2.1 Seitengröße
169
6.2.2 Satzspiegel
170
6.2.3 Einseitig oder doppelseitig?
174
6.2.4 Ränder
174
6.2.5 Navigationselemente und andere Elemente auf der Seite
176
6.3 Typografie
178
6.4 Digitale Ausgabeformate von Anleitungen
181
6.4.1 PDF als Online-Medium
181
6.4.2 Klassische Online-Medien
182
6.4.3 E-Books
183
6.4.4 Hörbücher
184
6.4.5 Video-Anleitungen
184
Kapitel 7
186
Sicherheitshinweise gestalten und formulieren
186
7.1 Aufgaben von Sicherheitshinweisen
186
7.2 Anforderungen an Sicherheitshinweise
187
7.3 Sicherheitshinweise gestalten
188
7.3.1 Hervorhebung
188
7.3.2 Aufbau
189
7.3.3 Symbole
189
7.4 Sicherheitshinweise formulieren und strukturieren
193
7.4.1 Schwere der Gefahr spezifizieren
193
7.4.2 Art und Quelle der Gefahr spezifizieren
196
7.4.3 Mögliche Folgen der Gefahr beschreiben
196
7.4.4 Instruktionen zur Abwehr der Gefahr geben
197
7.5 Eingebettete Sicherheitshinweise
197
7.6 Sicherheitshinweise platzieren
198
7.6.1 Grundsätzliche (allgemeine) Sicherheitshinweise
199
7.6.2 Abschnittsbezogene Sicherheitshinweise
199
7.6.3 Eingebettete Sicherheitshinweise
199
Kapitel 8
200
Visualisierung
200
8.1 Bedeutung von Abbildungen
200
8.2 Grafiksoftware
201
8.3 Abbildungen richtig einsetzen
201
8.3.1 Wann brauche ich ein Bild?
201
8.3.2 Text-Bild-Anordnung
210
8.3.3 Bildgröße
217
8.3.4 Ausschnitte
221
8.3.5 Bildunterschriften und Legenden
221
8.4 Abbildungsarten
222
8.4.1 Fotos
222
8.4.2 Strichzeichnungen
225
8.4.3 Screenshots
230
8.4.4 Symbole und Piktogramme
231
8.5 Grafische Auszeichnungen
233
8.6 Textlose Anleitungen
235
Kapitel 9
239
Anleitungen modular erstellen
239
9.1 Grundlagen der Modularisierung
239
9.1.1 Was ist Modularisierung?
239
9.1.2 Anwendungsbereiche
240
9.1.3 Chancen und Risiken
241
9.1.4 Redaktionssysteme
242
9.2 Vorgehensweise bei der Modularisierung von Anleitungen
243
9.2.1 Modularisierungskonzept festlegen
244
9.2.2 Module einteilen
248
9.3 Besonderheiten bei der Modularisierung
250
9.3.1 Metadaten
250
9.3.2 Statusverwaltung
251
9.3.3 Versionierung
251
9.3.4 Verwendungsnachweis
251
9.3.5 Querverweise
252
9.3.6 Übersetzungsmanagement
252
9.4 Neue Arbeitsabläufe durch Modularisierung
255
9.5 Auswahl eines Redaktionssystems
257
9.5.1 Basistechnologie XML
257
9.5.2 Auswahl der passenden Software
262
9.5.3 ROI-Berechnung
264
Kapitel 10
268
Redaktionsleitfaden
268
10.1 Anforderungen an einen Redaktionsleitfaden
268
10.2 Inhalte eines Redaktionsleitfadens
268
10.3 Einen Redaktionsleitfaden erarbeiten
270
Kapitel 11
272
Anleitungen für den US-Markt
272
11.1 Produkthaftungsrecht in den USA
272
11.2 Grundlegende inhaltliche Anforderungen an US-Anleitungen
274
11.2.1 Risikobeurteilung
275
11.2.2 Normenrecherche
276
11.2.3 Kapitelstruktur
276
11.3 Sicherheitshinweise nach ANSI Z535.6
277
11.3.1 Allgemeines zur ANSI Z535.6
278
11.3.2 Struktur und Elemente
279
11.3.3 Typen von Sicherheitshinweisen
281
11.4 Terminologie und Übersetzung
284
Kapitel 12
285
Die Anleitung im betriebswirtschaftlichen Kontext
285
12.1 Nutzenpotenziale
285
12.2 Technische Dokumentation verkaufen?
286
12.3 Dokumentationskosten
287
12.3.1 Recherche
287
12.3.2 Erstellung
287
12.3.3 Qualitätssicherung
288
12.3.4 Verwaltung
289
12.3.5 Übersetzung
289
12.4 Optimierungspotenziale
290
12.4.1 Abläufe/Informationsfluss
290
12.4.2 Automatisierung
291
12.4.3 Wissen des Technischen Redakteurs
292
Kapitel 13
293
Quellen
293
13.1 Abbildungen
293
13.2 Gesetze
293
13.3 EG-Richtlinien 13.4 Normen
294
13.5 ANSI-Standards 13.6 VDI-Richtlinien
295
Sachverzeichnis
296
All prices incl. VAT