Sie sind hier
E-Book

Grundlagen der Technischen Dokumentation

Anleitungen verständlich und normgerecht erstellen

AutorLars Kothes
VerlagSpringer-Verlag
Erscheinungsjahr2010
Seitenanzahl308 Seiten
ISBN9783642146688
FormatPDF
KopierschutzDRM
GerätePC/MAC/eReader/Tablet
Preis66,99 EUR
Technische Dokumentation ist die Aufbereitung und Publikation technischer Sachverhalte und Abläufe. Dabei spielen die Strukturierung der Information, die prägnante Formulierung von Texten, die visuelle Aufbereitung und die Wahl des Mediums eine wesentliche Rolle. Die Berücksichtigung von Gesetzen, Normen und Richtlinien kann dazu beitragen, Hersteller vor Schadensersatzforderungen zu schützen. Das Buch vermittelt grundlegendes Wissen für die externe Technische Dokumentation von Maschinen, Anlagen und anderen technischen Produkten.

Dipl.-Ing. Lars Kothes studierte Maschinenbau in Krefeld. Nachdem er fünf Jahre Erfahrung als Technischer Redakteur bei einem Dienstleister für technische Dokumentation gesammelt hatte, gründete er 2003 die Kothes! Technische Kommunikation GmbH & Co. KG. Seit 2001 ist er Regionalgruppenleiter der tekom-Regionalgruppe Nordrhein. 2008 wurde er von der IHK Mittlerer Niederrhein als Sachverständiger für Technische Dokumentation öffentlich bestellt und vereidigt.

Kaufen Sie hier:

Horizontale Tabs

Blick ins Buch
Inhaltsverzeichnis
Inhalt5
Kapitel 113
Grundlegendes13
1.1 Stellenwert der Technischen Dokumentation13
1.2 Arten von Technischer Dokumentation14
1.3 Berufsbild des Technischen Redakteurs15
Kapitel 217
Gesetze, Richtlinien und Normen17
2.1 Grundlagen der CE-Kennzeichnung17
2.1.1 Die Europäische Union18
2.1.2 Gesetzgebungsverfahren in der EU19
2.1.3 EG-Richtlinien nach „Neuer Konzeption“ (New Approach)19
2.1.4 Marktaufsicht21
2.1.5 Geltungsbereich der EG-Richtlinien22
2.2 Geräteund Produktsicherheitsgesetz und EG-Richtlinien23
2.2.1 Geräteund Produktsicherheitsgesetz (GPSG)23
2.2.2 Maschinenrichtlinie24
2.2.3 Niederspannungsrichtlinie26
2.2.4 EMV-Richtlinie26
2.2.5 Geräte in explosionsgefährdeten Bereichen (ATEX)27
2.2.6 Medizinprodukterichtlinie28
2.2.7 Weitere Richtlinien29
2.3 Produkthaftung30
2.4 Normen31
2.4.1 Grundlagen der Normung31
2.4.2 DIN EN 6207934
2.4.3 DIN EN ISO 12100-238
2.4.4 ISO Guide 3740
2.4.5 VDI 450042
2.4.6 DIN-Fachbericht 14645
2.4.7 DIN EN 1503847
2.5 Formale Anforderungen an die Anleitung49
2.5.1 Vollständigkeit49
2.5.2 Verständlichkeit49
2.5.3 Lieferform50
2.5.4 Zeitpunkt der Bereitstellung50
2.5.5 Sprache51
2.5.6 Muss der Nutzer die Anleitung eigentlich lesen?51
2.6 Spezielle Anforderungen an Softwaredokumentation52
2.6.1 Internationale Normen52
2.6.2 Software als Bestandteil eines Produkts oder Geräts52
2.6.3 Anwendbarkeit des Geräteund Produktsicherheitsgesetzes (GPSG)53
2.6.4 Mängelgewährleistung53
2.6.5 Sicherheitsanforderungen und abgeleitete Pflichten53
2.6.6 Sprachen55
2.7 Die Risikobeurteilung – Grundlage der Betriebsanleitung55
Kapitel 359
Dokumentationsprozess59
3.1 Projektplanung59
3.1.1 Zuständigkeiten60
3.2 Zielgruppenanalyse60
3.2.1 Zielgruppensegmentierung61
3.2.2 Zielgruppencharakterisierung62
3.3 Recherche63
3.3.1 Recherchecheckliste erstellen63
3.3.2 Vorhandene Informationen auswerten65
3.3.3 Recherche vorbereiten66
3.3.4 Recherche durchführen66
3.3.5 Recherche auswerten67
3.4 Erstellung68
3.4.1 Erstellungsprozess68
3.4.2 Tipps für optimale Arbeitsabläufe beim Erstellungsprozess68
3.5 Qualitätssicherung70
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 Übersetzung75
3.7 Stolpersteine76
3.8 Prozesse optimieren77
Kapitel 479
Inhalte der Anleitung79
4.1 Deckblatt79
4.2 Impressum81
4.3 Inhaltsverzeichnis81
4.4 Allgemeines81
4.4.1 Informationen zu dieser Anleitung82
4.4.2 Symbolerklärung82
4.4.3 Haftungsbeschränkung*83
4.4.4 Urheberschutz84
4.4.5 Garantie und Gewährleistung84
4.5 Sicherheit85
4.5.1 Bestimmungsgemäße Verwendung86
4.5.2 Allgemeine Gefahrenquellen86
4.5.3 Verantwortung des Betreibers*88
4.5.4 Personalqualifikation89
4.5.5 Sicherheitskennzeichnung90
4.5.6 Schutzausrüstung91
4.5.7 Sicherheitseinrichtungen92
4.5.8 Sichern gegen Wiedereinschalten94
4.5.9 Verhalten im Gefahrenfall94
4.5.10 Umweltschutz95
4.6 Technische Daten95
4.6.1 Darstellung der Technischen Daten*96
4.6.2 Technische Daten im Einzelnen96
4.6.3 Alternative Darreichungsformen98
4.7 Aufbau und Funktion99
4.7.1 Kurzbeschreibung*99
4.7.2 Übersicht99
4.7.3 Lieferumfang*102
4.7.4 Prozessoder Funktionsbeschreibung102
4.7.5 Beschreibung der Baugruppen*103
4.7.6 Anschlüsse104
4.7.7 Anzeigen und Bedienelemente105
4.7.8 Bediensoftware106
4.7.9 Arbeitsplätze und Gefahrenbereiche107
4.7.10 Betriebsarten108
4.7.11 Zubehör, Werkzeuge109
4.8 Transport109
4.8.1 Sicherheit109
4.8.2 Transportinspektion*110
4.8.3 Symbole auf der Verpackung*111
4.8.4 Verpackung111
4.8.5 Transport113
4.8.6 Lagerung114
4.9 Installation und Erstinbetriebnahme114
4.9.1 Sicherheit117
4.9.2 Anforderungen an den Aufstellort117
4.9.3 Vorbereitungen118
4.9.4 Installation118
4.9.5 Anschließen119
4.9.6 Erstinbetriebnahme120
4.10 Bedienung, Betrieb120
4.10.1 Sicherheit121
4.10.2 Tätigkeiten vor Gebrauch121
4.10.3 Einund Ausschalten122
4.10.4 Normalbetrieb123
4.10.5 Besondere Handlungen123
4.10.6 Tätigkeiten nach der Benutzung124
4.10.7 Reinigung, Desinfektion, Sterilisation124
4.11 Wartung124
4.11.1 Sicherheit125
4.11.2 Wartungsplan125
4.11.3 Wartungsarbeiten127
4.12 Störungen128
4.12.1 Sicherheit129
4.12.2 Störungsanzeigen129
4.12.3 Verhalten bei Störungen130
4.12.4 Störungstabelle131
4.12.5 Arbeiten zur Störungsbeseitigung133
4.13 Demontage, Entsorgung133
4.13.1 Sicherheit133
4.13.2 Demontage134
4.13.3 Entsorgung134
4.14 Glossar135
4.15 Index135
4.16 Anhang138
4.16.1 Konformitätserklärung139
4.16.2 Qualitätsdokumentation139
4.16.3 Datenblätter140
4.16.4 Checklisten, Prüfbücher140
4.16.5 Anleitungen der Lieferanten140
Kapitel 5142
Anleitungen formulieren142
5.1 Verständlich formulieren142
5.1.1 Kurze und einfache Sätze formulieren143
5.1.2 Substantivierungen vermeiden143
5.1.3 Sätze nicht über Aufzählungen fortsetzen143
5.1.4 Klemmkonstruktionen vermeiden144
5.1.5 Funktionsverbgefüge vermeiden144
5.2 Präzise formulieren145
5.2.1 Eindeutige Terminologie145
5.2.2 Abstrakte Begriffe und Fremdwörter vermeiden145
5.2.3 Einzelheiten direkt benennen146
5.2.4 Abkürzungen vermeiden146
5.2.5 Firmenjargon vermeiden146
5.2.6 Füllwörter vermeiden147
5.2.7 Weichmacher vermeiden147
5.3 Einheitlich formulieren148
5.3.1 Einheitliche Anrede148
5.3.2 Einheiten und Werte149
5.3.3 Komposita übersichtlich schreiben149
5.4 Überschriften korrekt wählen150
5.5 Textwüsten vermeiden, Texte strukturieren150
5.6 Handlungsanweisungen formulieren151
5.6.1 Handlungsanweisung betiteln151
5.6.2 Voraussetzungen definieren151
5.6.3 Handlungsschritte typografisch hervorheben154
5.6.4 Handlungsschritte aktivisch formulieren155
5.6.5 Handlungsschritte vollständig formulieren155
5.6.6 Eine Handlung je Handlungsschritt156
5.6.7 Richtige Reihenfolge einhalten157
5.6.8 Beispiel für eine gute Handlungsanweisung157
5.7 Querverweise setzen157
5.8 Übersetzungsgerecht schreiben161
Kapitel 6162
Anleitungen gestalten162
6.1 Funktionsund zielgruppengerechte Gestaltung162
6.1.1 Zweck der Gestaltung162
6.1.2 Einfluss der Zielgruppe163
6.1.3 Einfluss des Produktes165
6.1.4 Entwicklung einer zweckgerichteten Gestaltung166
6.2 Seitengestaltung169
6.2.1 Seitengröße169
6.2.2 Satzspiegel170
6.2.3 Einseitig oder doppelseitig?174
6.2.4 Ränder174
6.2.5 Navigationselemente und andere Elemente auf der Seite176
6.3 Typografie178
6.4 Digitale Ausgabeformate von Anleitungen181
6.4.1 PDF als Online-Medium181
6.4.2 Klassische Online-Medien182
6.4.3 E-Books183
6.4.4 Hörbücher184
6.4.5 Video-Anleitungen184
Kapitel 7186
Sicherheitshinweise gestalten und formulieren186
7.1 Aufgaben von Sicherheitshinweisen186
7.2 Anforderungen an Sicherheitshinweise187
7.3 Sicherheitshinweise gestalten188
7.3.1 Hervorhebung188
7.3.2 Aufbau189
7.3.3 Symbole189
7.4 Sicherheitshinweise formulieren und strukturieren193
7.4.1 Schwere der Gefahr spezifizieren193
7.4.2 Art und Quelle der Gefahr spezifizieren196
7.4.3 Mögliche Folgen der Gefahr beschreiben196
7.4.4 Instruktionen zur Abwehr der Gefahr geben197
7.5 Eingebettete Sicherheitshinweise197
7.6 Sicherheitshinweise platzieren198
7.6.1 Grundsätzliche (allgemeine) Sicherheitshinweise199
7.6.2 Abschnittsbezogene Sicherheitshinweise199
7.6.3 Eingebettete Sicherheitshinweise199
Kapitel 8200
Visualisierung200
8.1 Bedeutung von Abbildungen200
8.2 Grafiksoftware201
8.3 Abbildungen richtig einsetzen201
8.3.1 Wann brauche ich ein Bild?201
8.3.2 Text-Bild-Anordnung210
8.3.3 Bildgröße217
8.3.4 Ausschnitte221
8.3.5 Bildunterschriften und Legenden221
8.4 Abbildungsarten222
8.4.1 Fotos222
8.4.2 Strichzeichnungen225
8.4.3 Screenshots230
8.4.4 Symbole und Piktogramme231
8.5 Grafische Auszeichnungen233
8.6 Textlose Anleitungen235
Kapitel 9239
Anleitungen modular erstellen239
9.1 Grundlagen der Modularisierung239
9.1.1 Was ist Modularisierung?239
9.1.2 Anwendungsbereiche240
9.1.3 Chancen und Risiken241
9.1.4 Redaktionssysteme242
9.2 Vorgehensweise bei der Modularisierung von Anleitungen243
9.2.1 Modularisierungskonzept festlegen244
9.2.2 Module einteilen248
9.3 Besonderheiten bei der Modularisierung250
9.3.1 Metadaten250
9.3.2 Statusverwaltung251
9.3.3 Versionierung251
9.3.4 Verwendungsnachweis251
9.3.5 Querverweise252
9.3.6 Übersetzungsmanagement252
9.4 Neue Arbeitsabläufe durch Modularisierung255
9.5 Auswahl eines Redaktionssystems257
9.5.1 Basistechnologie XML257
9.5.2 Auswahl der passenden Software262
9.5.3 ROI-Berechnung264
Kapitel 10268
Redaktionsleitfaden268
10.1 Anforderungen an einen Redaktionsleitfaden268
10.2 Inhalte eines Redaktionsleitfadens268
10.3 Einen Redaktionsleitfaden erarbeiten270
Kapitel 11272
Anleitungen für den US-Markt272
11.1 Produkthaftungsrecht in den USA272
11.2 Grundlegende inhaltliche Anforderungen an US-Anleitungen274
11.2.1 Risikobeurteilung275
11.2.2 Normenrecherche276
11.2.3 Kapitelstruktur276
11.3 Sicherheitshinweise nach ANSI Z535.6277
11.3.1 Allgemeines zur ANSI Z535.6278
11.3.2 Struktur und Elemente279
11.3.3 Typen von Sicherheitshinweisen281
11.4 Terminologie und Übersetzung284
Kapitel 12285
Die Anleitung im betriebswirtschaftlichen Kontext285
12.1 Nutzenpotenziale285
12.2 Technische Dokumentation verkaufen?286
12.3 Dokumentationskosten287
12.3.1 Recherche287
12.3.2 Erstellung287
12.3.3 Qualitätssicherung288
12.3.4 Verwaltung289
12.3.5 Übersetzung289
12.4 Optimierungspotenziale290
12.4.1 Abläufe/Informationsfluss290
12.4.2 Automatisierung291
12.4.3 Wissen des Technischen Redakteurs292
Kapitel 13293
Quellen293
13.1 Abbildungen293
13.2 Gesetze293
13.3 EG-Richtlinien 13.4 Normen294
13.5 ANSI-Standards 13.6 VDI-Richtlinien295
Sachverzeichnis296

Weitere E-Books zum Thema: Systemadministration - IT

Der richtige Weg zur Softwareauswahl

E-Book Der richtige Weg zur Softwareauswahl
Lastenheft, Pflichtenheft, Compliance, Erfolgskontrolle Format: PDF

Sie treffen täglich Entscheidungen. Doch selten ist eine so komplex wie die Auswahl einer Software. Gute Vorbereitung ist daher umso wichtiger. Sie wollen die notwendige Qualität des Lasten- bzw.…

Information Lifecycle Management

E-Book Information Lifecycle Management
Prozessimplementierung Format: PDF

Im Zusammenhang mit IT-Governance, Sarbanes-Oxley Act und Basel II ist Information Lifecycle Management (ILM), ein Thema, das jeder CIO beherrschen muss. Information ist ein Produkt, das einem…

Strategisches IT-Management

E-Book Strategisches IT-Management
Wert steigern, Leistung steuern, Kosten senken. Format: PDF

Strategisch und umfassend für Top-Entscheider wird der Themenkomplex der IT im Unternehmen ergebnisorientiert und klar verständlich aufbereitet. Mit vielen nützlichen Checklisten.Dr.-Ing. Dirk Buchta…

Zwischenbetriebliches Stammdatenmanagement

E-Book Zwischenbetriebliches Stammdatenmanagement
Lösungen für die Datensynchronisation zwischen Handel und Konsumgüterindustrie Format: PDF

Die effiziente Abwicklung zwischenbetrieblicher Marketing- oder Logistikprozesse setzt unternehmensübergreifend abgestimmte Stammdaten zu Produkten, Geschäftspartnern und Konditionen voraus. Der…

Strategisches IT-Management

E-Book Strategisches IT-Management
Management von IT und IT-gestütztes Management Format: PDF

Renommierte Autoren beleuchten die Schnittstellen zwischen IT, IT-Management und strategischem Management aus zwei Perspektiven. Zum einen diskutieren sie moderne Konzepte, Ansätze und Strategien des…

Zwischenbetriebliches Stammdatenmanagement

E-Book Zwischenbetriebliches Stammdatenmanagement
Lösungen für die Datensynchronisation zwischen Handel und Konsumgüterindustrie Format: PDF

Die effiziente Abwicklung zwischenbetrieblicher Marketing- oder Logistikprozesse setzt unternehmensübergreifend abgestimmte Stammdaten zu Produkten, Geschäftspartnern und Konditionen voraus. Der…

Zwischenbetriebliches Stammdatenmanagement

E-Book Zwischenbetriebliches Stammdatenmanagement
Lösungen für die Datensynchronisation zwischen Handel und Konsumgüterindustrie Format: PDF

Die effiziente Abwicklung zwischenbetrieblicher Marketing- oder Logistikprozesse setzt unternehmensübergreifend abgestimmte Stammdaten zu Produkten, Geschäftspartnern und Konditionen voraus. Der…

Steuerung der IT im Klinikmanagement

E-Book Steuerung der IT im Klinikmanagement
Methoden und Verfahren Format: PDF

Unter dem wachsenden Kostendruck im Krankenhaus wird die Effizienz der Leistungserbringung immer wichtiger. Dabei spielt die IT eine zunehmend bedeutsamere Rolle. Sie ist inzwischen ein nicht mehr…

Information Lifecycle Management

E-Book Information Lifecycle Management
Prozessimplementierung Format: PDF

Im Zusammenhang mit IT-Governance, Sarbanes-Oxley Act und Basel II ist Information Lifecycle Management (ILM), ein Thema, das jeder CIO beherrschen muss. Information ist ein Produkt, das einem…

Weitere Zeitschriften

MENSCHEN. das magazin

MENSCHEN. das magazin

MENSCHEN. das magazin informiert über Themen, die das Zusammenleben von Menschen in der Gesellschaft bestimmen -und dies konsequent aus Perspektive der Betroffenen. Die Menschen, um die es geht, ...

Arzneimittel Zeitung

Arzneimittel Zeitung

Die Arneimittel Zeitung ist die Zeitung für Entscheider und Mitarbeiter in der Pharmabranche. Sie informiert branchenspezifisch über Gesundheits- und Arzneimittelpolitik, über Unternehmen und ...

Card Forum International

Card Forum International

Card Forum International, Magazine for Card Technologies and Applications, is a leading source for information in the field of card-based payment systems, related technologies, and required reading ...

Correo

Correo

 La Revista de Bayer CropScience para la Agricultura ModernaPflanzenschutzmagazin für den Landwirt, landwirtschaftlichen Berater, Händler und am Thema Interessierten mit umfassender ...

DSD Der Sicherheitsdienst

DSD Der Sicherheitsdienst

Der "DSD – Der Sicherheitsdienst" ist das Magazin der Sicherheitswirtschaft. Es erscheint viermal jährlich und mit einer Auflage von 11.000 Exemplaren. Der DSD informiert über aktuelle Themen ...

ea evangelische aspekte

ea evangelische aspekte

evangelische Beiträge zum Leben in Kirche und Gesellschaft Die Evangelische Akademikerschaft in Deutschland ist Herausgeberin der Zeitschrift evangelische aspekte Sie erscheint viermal im Jahr. In ...