|
Woran Sie gute Dokumentation erkennen
|
|
Anhand welcher Qualitätskriterien erkennen Sie eine gute Technische Dokumentation oder eine gute Online-Hilfe, wenn Sie selbst kein Dokumentationsexperte sind? Woran können Sie die Qualität dessen beurteilen, was Ihnen ein Dokumentations-Dienstleister anbietet oder liefert?
Der wichtigste Punkt gleich vorweg: Schließen Sie nicht von sich auf andere. Nicht alles, was Ihnen persönlich gefällt, wird auch den Anwendern Ihrer Produkte gefallen. Sie selbst kennen Ihr Produkt – Ihre Kunden noch nicht.
Die wenigsten Anwender interessieren sich dafür, wie Ihr Produkt funktioniert – auch wenn Sie als Entwickler und Hersteller zu Recht stolz darauf sind. Anwender wollen ganz einfach schnell und unkompliziert zum Ziel kommen und lesen Technische Dokumentation oder Online-Hilfen nur, wenn Sie ein konkretes Problem vor Augen haben. Dieses Problem müssen sie in der Dokumentation wiederfinden.
| ▪ | Entspricht der Aufbau der Dokumentation der technischen Architektur Ihres Produkts (schlecht) oder spiegeln die Themen die Aufgaben und Ziele der Anwender wider (gut)? |
| ▪ | Enthält die Dokumentation das, was Sie sagen möchten (schlecht) oder das, was der Anwender wissen will (gut)? |
| ▪ | Wird beschrieben, was der Anwender ohnehin am Produkt sieht (schlecht), oder das, was er nicht sieht (gut)? Wird das Produkt beschrieben (schlecht) oder seine Anwendung (gut)? |
|
| ▪ | Ist die Gliederung flach, einfach und übersichtlich? Oder gibt es Kapitel, Unterkapitel, Unterunterkapitel, Unterunterunterkapitel, ...? |
| ▪ | Entspricht die Reihenfolge der Kapitel der Häufigkeit, in der die Kapitel benötigt werden? Steht das Wichtigere vor dem Unwichtigeren, das Allgemeine vor dem Speziellen? |
|
| ▪ | Ist der Text sauber durch Zwischenüberschriften untergliedert? Oder gibt es lange, unübersichtliche Textabschnitte? |
| ▪ | Wird in jedem Absatz nur ein Thema behandelt oder sind die Inhalte vermischt? |
| ▪ | Sind Handlungsanleitungen nummeriert und klar als solche erkennbar? |
| ▪ | Kann der Anwender gezielt ausschließlich das lesen, was ihn in einer bestimmten Situation interessiert: Einführung, schrittweise Anleitung oder Detailinformation? Oder sind die Informationstypen vermischt, so dass jeder Anwender immer alles lesen muss? |
|
| ▪ | Wie eng und mediengerecht ist die Anbindung einer Online-Dokumentation an die Software? Lässt sich lediglich eine PDF-Datei aufrufen? Oder ist die Online-Hilfe kontextsensitiv oder sogar direkt in die Software-Oberfläche integriert ("embedded")? |
| ▪ | Ist eine Online-Hilfe lediglich ein "Handbuch am Bildschirm" oder nutzt sie die Möglichkeiten des Mediums, wie z.B. Interaktion, Animation, Personalisierung? |
|
| ▪ | Gibt es ein anwenderfreundliches, klar durchdachtes Navigationskonzept, oder gibt es Links / Querverweise "von überall nach überall"? |
| ▪ | Existiert ein redaktionell bearbeiteter Index oder nur ein automatisch generierter Index? |
| ▪ | Enthält der Index auch Synonyme? (Beispiel: Würde ein Thema "Auto" auch unter "Fahrzeug", "PKW" oder "Kfz" gefunden?) |
| ▪ | Ist der Index mehrstufig und sind alle Indexbegriffe eindeutig, oder gibt es zu einzelnen Begriffen mehrere Zielstellen, zwischen denen sich der Anwender entscheiden muss? |
|
| ▪ | Vermittelt der Text Vertrauen, Zuversicht und Sicherheit, oder wirkt er eher einschüchternd? |
| ▪ | Wird der Leser direkt angesprochen (Beispiel: "Klicken Sie ...") oder gibt es unpersönliche Formulierungen bei denen unklar bleibt, wer handelt (Beispiel: "Es muss ... durchgeführt werden")? |
| ▪ | Gibt es unpräzise Formulierungen aus denen nicht eindeutig hervorgeht ob zwingend gehandelt werden muss oder ob optional gehandelt werden kann ("eventuell", "sollte")? |
| ▪ | Sind alle Überschriften eindeutig formuliert, so dass sich bereits im Vorfeld der Inhalt eines Themas eindeutig erkennen lässt? Oder muss der Anwender jedes Thema zunächst einmal anlesen um zu sehen, ob der Inhalt für Ihn überhaupt relevant ist? (Beispiel: Ein Thema heißt lediglich "Überblick". Überblick über was?) |
| ▪ | Dieselbe Regel gilt auch für Links einer Online-Hilfe. Sind sie so eindeutig formuliert, dass der Anwender bereits vor dem Anklicken erkennen kann, ob sich der Exkurs lohnt? |
|
| ▪ | Folgt die gesamte Dokumentation zu einer Produktfamilie einem einheitlichen Konzept, oder muss sich der Anwender überall erneut zurechtfinden? |
| ▪ | Werden Fachbegriffe und Bezeichnungen konsistent verwendet, oder heißt ein und dieselbe Sache einmal so und später wieder anders? |
| ▪ | Entsprechen die in der Dokumentation verwendeten Begriffe denen, die sich auch auf dem Gerät bzw. in der Software wiederfinden? |
|
| ▪ | Machen Struktur und Formulierung dem Leser die Suche und Informationsaufnahme so einfach wie möglich? Ist es möglich, auch nur punktuell auf einzelne Informationen zuzugreifen? |
| ▪ | Steht die wichtigste Information am Anfang? |
| ▪ | Steht die Information, die alle Anwender brauchen vor der Information, die nur wenige Anwender interessiert? |
| ▪ | Stehen häufig benötigte Informationen vor seltener benötigten Informationen? |
| ▪ | Stehen allgemeingültige Informationen vor Informationen für Spezialfälle? |
| ▪ | Steht inhaltlich Zusammengehöriges auch räumlich zusammen? |
| ▪ | Stehen die Schlüsselbegriffe im Satz möglichst weit vorne? |
| ▪ | Sind die Sätze kurz und einfach? Können auch Nicht-Muttersprachler den Text verstehen? |
| ▪ | Trägt jeder Satz nur eine Information? |
| ▪ | Wird auf inhaltslose Füllwörter und Floskeln verzichtet? |
|
| ▪ | Wirkt das Layout professionell und funktional? Oder ist es bunt und überladen und lenkt von den eigentlichen Inhalten ab? |
| ▪ | Unterstützt das Layout ein schnelles Überfliegen und Querlesen? |
| ▪ | Werden in einer Online-Dokumentation bildschirmtaugliche, serifenlose Schriftarten verwendet? |
| ▪ | Bleiben in einer Online-Dokumentation Unterstreichungen ausschließlich der Auszeichnung von Links vorbehalten? Kann der Anwender auf einen Blick erkennen, was anklickbar ist und was nicht? |
|
| ▪ | Wird die Dokumentation mit einem geeigneten Autorensystem erstellt oder "von Hand zusammengestrickt"? Kann die Dokumentation mit wenig Aufwand überarbeitet und neu produziert werden? Wurden z.B. für Seitenumbrüche bereits im Autorensystem automatische Regeln hinterlegt, oder muss bei jeder Überarbeitung und Übersetzung manuell layoutet werden? |
| ▪ | Sind Autorensystem und Format zukunftssicher? |
| ▪ | Wird beim Schreiben auf Lokalisierbarkeit und Übersetzungsfreundlichkeit geachtet? |
| ▪ | Unterstützen Format, Autorensystem und Dokumentaufbau "Single Sourcing", d.h. die zukünftige Ausgabe in weiteren Ausgabemedien, Formaten und Versionen? |
|
Siehe auch
Angebote vergleichen
|
|
|
|
|
 |
Software-Dokumentation
seit 1989
|
 |
Handbücher und Online-Hilfen kostengünstig aus gemeinsamer Textquelle
seit 1995 |
|
Zahlreiche Fachvorträge und Publikationen, u.a. zu den Themen:
Informationsdesign,
Benutzerführung und Navigation,
Embedded User Assistance,
Single Source Publishing,
Autorenwerkzeuge
Prozessoptimierung in der Technischen Dokumentation
|
|
| Goldene Diskette des Computermagazins CHIP |
|
| Mitglied im deutschen Fachverband für Technische Kommunikation und Informationsentwicklung |
|
Intro zeigen:  |
|
|
