Sie sind hier
E-Book

Technische Dokumentation

Praktische Anleitungen und Beispiele

AutorDietrich Juhl
VerlagSpringer-Verlag
Erscheinungsjahr2006
Seitenanzahl262 Seiten
ISBN9783540278481
FormatPDF
KopierschutzDRM
GerätePC/MAC/eReader/Tablet
Preis49,99 EUR
Die 2. Auflage führt das bewährte Konzept - angereichert mit neuen Beispielen - weiter. Der Autor gibt einfach nachvollziehbare Vorgaben in Form von Bausteinen, nach denen Bedienungsanleitungen und technische Dokumentationen geschrieben werden können. Geboten werden ein geschlossenes Konzept und praktische Rezepte für verständliche Formulierungen. Zudem liefert das Buch die Grundlagen für eine XML-strukturierte Dokumentation, die zunehmend eingesetzt wird. Mehr als 100 vorbildliche Beispiele veranschaulichen das Thema.

Dietrich Juhl arbeitet seit mehr als 20 Jahren auf dem Gebiet der technischen Dokumentation. Er ist technischer Redakteur, hat selbst viele Anleitungen geschrieben, in Aus- und Weiterbildung Studierende und Praktiker unterrichtet und arbeitet heute als freier Berater und Trainer. Anleitungen nach Konzepten des Autors haben bei mehreren Vergleichstests gewonnen.

Kaufen Sie hier:

Horizontale Tabs

Leseprobe
Das Konzept (S.21)

Im Folgenden möchte ich Ihnen ein Konzept vorstellen, das Ihnen schnell hilft, gute Anleitungen in kurzer Zeit zu erstellen. Beachten Sie dazu auch das Bild auf der nächsten Seite.

Fünf Inhalte

Die fünf Inhalte bilden den Kern der Anleitung. Wenn Sie diese Inhalte richtig beschreiben, haben Sie die notwendigen Informationen fixiert. Diese „lean documentation" würde dem Anwender im Grunde genügen, das Gerät zu verstehen und zu bedienen. Alle weiteren Elemente (außen herum) sind nicht unbedingt notwendig, in vielen Fällen aber hilfreich. (Eine Ausnahme bilden natürlich die Sicherheitshinweise.)

Strukturen zum Schreiben

Im weiteren Verlauf des Buches finden Sie Strukturen, mit deren Hilfe Sie die Inhalte und alle weiteren Elemente einfach (d.h. ohne viel Nachdenken) schreiben können.

Umrandung

Die vielen Elemente der Umrandung (siehe Bild) helfen Ihnen, Ihre Inhalte gezielt zu ergänzen, und die Anleitung so zu komplettieren, dass sich ein Buch ergibt.

Vorteil der inhaltlichen Trennung

Die Trennung der Inhalte in die fünf Kategorien bietet Ihnen beim Schreiben viele Vorteile:

• Sie haben von Anfang an eine Grobgliederung.

• Sie haben für alle Inhalts-Elemente eine Struktur, nach der Sie formulieren können.

• Sie können die einzelnen Inhalts-Elemente gezielt optimieren.

• Sie haben sehr schnell eine Anleitung, die alle notwendigen Informationen enthält.

Reihenfolge beim Schreiben

Wenn Sie sich beim Schreiben zuerst auf die fünf Inhalte konzentrieren, behalten Sie einen besseren Überblick und lenken sich selbst nicht durch andere Elemente ab. Erst wenn Sie die fünf Inhalte fertig haben, sollten Sie sie durch die speziellen Inhalte, Verständnis- und Ordnungselemente ergänzen. Dabei helfen Ihnen auch hier die konkreten Strukturen beim Schreiben. Viele Elemente der Umrandung liegen strukturell fest und lassen sich so standardisieren, dass sie vom DTP- oder DMS-System automatisch zusammengestellt werden können.

Inhalte

Den Kern einer Anleitung bilden die fünf Inhalte:

• Leistungsbeschreibung,

• Gerätebeschreibung,

• Tätigkeitsbeschreibung,

• ggf. Funktionsweise (nur notwendig, wenn der Benutzer die Funktionsweise verstehen muss),

• ggf. Technische Unterlagen (wie z.B. Konstruktionszeichnung, Schaltplan, Ersatzteilliste...)

In den fünf Inhalten stehen die wesentlichen Punkte für den Benutzer, um das Gerät kennenzulernen und die möglichen oder notwendigen Tätigkeiten zu erlernen.

Umrandung

Um die fünf Inhalte herum sind viele weitere Elemente angeordnet. Sie dienen dem Benutzer zu unterschiedlichen Zwecken:

• zur Orientierung (Ordnungselemente),

• helfen ihm schwierige Dinge zu verstehen (Verständniselemente)

• oder sind spezielle Inhalte, die in ihrer Form häufig festliegen.

Die fünf Inhalte

Die fünf Inhalte liefern dem Benutzer die benötigten Informationen in der richtigen Reihenfolge. Zuerst erfährt er wichtige Grundlagen zum Verständnis (Leistungs- und Gerätebeschreibung) und bekommt in der Tätigkeitsbeschreibung die konkrete Anleitung zum Handeln. Die Beschreibung der Funktionsweise und die Technischen Unterlagen sind bei einfachen Geräten nicht notwendig.
Blick ins Buch
Inhaltsverzeichnis
Vorwort5
Vorwort zur zweiten Auflage7
Der Autor8
Inhaltsverzeichnis9
Einleitung11
Exkurs: Strukturierte Dokumentation und XML14
Hinweise zu diesem Buch17
Lesehinweise zu diesem Buch17
Die Rolle der Bedienungsanleitung im Kontext Bedienkonzept Anleitung Schulung Anwendung19
Exkurs: Vorschriften, Gesetze, Sicherheit20
Ausblick: Bald elektronische Anleitungen21
Handlungsorientierung22
Was ist Technische Dokumentation?25
Was-macht-Wer?-Matrix27
Das Konzept29
Inhalte32
Umrandung33
Die fünf Inhalte34
Leistungsbeschreibung35
Gerätebeschreibung43
Tätigkeitsbeschreibung53
TB 1: Handlungsanweisung57
TB 2: Beschreibung der Bedienelemente69
TB 3 : Software-Funktionsbeschreibung72
TB 4: Abbildung der Handlung77
TB 5 : Abbildung des Handlungsergebnisses80
TB 6 : Vermittlung von Systematik84
TB 7: Regeln87
TB 8 : Systembeschreibung92
Gegenüberstellung der möglichen Tätigkeitsbeschreibungsarten94
Exkurs: Anleitung auf Handlungsorientierung prüfen97
Beschreibung der Funktionsweise99
Technische Unterlagen109
Ordnungselemente121
Titelblatt124
Inhaltsverzeichnis126
Zu dieser Anleitung129
Seitenzahlen133
Register135
Lebende Kolumnentitel137
Bildverzeichnis140
Literaturverzeichnis142
Index, Stichwortverzeichnis143
Exkurs: Volltextsuche bei elektronischen Anleitungen145
Rückseite147
Verständniselemente149
Advance Organizer152
Merksatz154
Beispiele, Übungen155
Zusammenfassung156
Glossar158
Spezielle Inhalte161
Impressum164
Sicherheitshinweise166
Vorwort171
Bestimmungsgemäßer Gebrauch172
Technische Daten174
Lieferumfang176
Wartungsplan178
Fehlersuchtabelle179
Garantie184
Credits186
Adressen187
Exkurs: Reihenfolge beim Schreiben189
Komplette Anleitungen191
Normale Anleitung194
Sofort-Anleitung202
Exemplarische Einführung207
Nachschlage-Anleitung209
Kurzanleitung213
Schnellstart-Anleitung218
Software-Dokumentation bei „kleiner“ Software220
Software-Dokumentation bei umfangreicher Software222
Exkurs: Vergleich geräteorientierte / handlungsorientierte Anleitung225
Allgemeine Technische Dokumentation227
Planungsunterlage230
Installations-Anleitung, Montage-Anleitung233
Wartungsanleitung237
Service-Anleitung240
Ersatzteil-Katalog245
Anlagen-Dokumentation249
Anhang251
Gesamtstruktur253
Normen und Richtlinien257
Index265

Weitere E-Books zum Thema: Systemadministration - IT

Linux-Systemadministration

E-Book Linux-Systemadministration
Grundlagen, Konzepte, Anwendung Format: PDF

Linux ist eine fest etablierte, für vielfältige Rechnerarchitekturen verfügbare Plattform und zeichnet sich insbesondere durch die hohe Stabilität und Sicherheit des Systems aus. Dieses Buch bietet…

Linux-Systemadministration

E-Book Linux-Systemadministration
Grundlagen, Konzepte, Anwendung Format: PDF

Linux ist eine fest etablierte, für vielfältige Rechnerarchitekturen verfügbare Plattform und zeichnet sich insbesondere durch die hohe Stabilität und Sicherheit des Systems aus. Dieses Buch bietet…

Linux-Systemadministration

E-Book Linux-Systemadministration
Grundlagen, Konzepte, Anwendung Format: PDF

Linux ist eine fest etablierte, für vielfältige Rechnerarchitekturen verfügbare Plattform und zeichnet sich insbesondere durch die hohe Stabilität und Sicherheit des Systems aus. Dieses Buch bietet…

Linux-Systemadministration

E-Book Linux-Systemadministration
Grundlagen, Konzepte, Anwendung Format: PDF

Linux ist eine fest etablierte, für vielfältige Rechnerarchitekturen verfügbare Plattform und zeichnet sich insbesondere durch die hohe Stabilität und Sicherheit des Systems aus. Dieses Buch bietet…

Weitere Zeitschriften

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 ...

arznei-telegramm

arznei-telegramm

Das arznei-telegramm® informiert bereits im 53. Jahrgang Ärzte, Apotheker und andere Heilberufe über Nutzen und Risiken von Arzneimitteln. Das arznei-telegramm®  ist neutral und ...

Berufsstart Gehalt

Berufsstart Gehalt

»Berufsstart Gehalt« erscheint jährlich zum Sommersemester im Mai mit einer Auflage von 50.000 Exemplaren und ermöglicht Unternehmen sich bei Studenten und Absolventen mit einer ...

Bibel für heute

Bibel für heute

BIBEL FÜR HEUTE ist die Bibellese für alle, die die tägliche Routine durchbrechen wollen: Um sich intensiver mit einem Bibeltext zu beschäftigen. Um beim Bibel lesen Einblicke in Gottes ...

crescendo

crescendo

Die Zeitschrift für Blas- und Spielleutemusik in NRW - Informationen aus dem Volksmusikerbund NRW - Berichte aus 23 Kreisverbänden mit über 1000 Blasorchestern, Spielmanns- und Fanfarenzügen - ...

Der Steuerzahler

Der Steuerzahler

Der Steuerzahler ist das monatliche Wirtschafts- und Mitgliedermagazin des Bundes der Steuerzahler und erreicht mit fast 230.000 Abonnenten einen weitesten Leserkreis von 1 ...

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 ...

filmdienst#de

filmdienst#de

filmdienst.de führt die Tradition der 1947 gegründeten Zeitschrift FILMDIENST im digitalen Zeitalter fort. Wir begleiten seit 1947 Filme in allen ihren Ausprägungen und Erscheinungsformen.  ...