Starter-Formatvorlage für Benutzerhandbücher

Wenn Sie eine Formatvorlage (ein Template) für eine Produktdokumentation oder IT-Dokumentation erstellen, können Sie eine ganze Menge Fehler machen:

▶  Sie können viele Stunden damit verbringen, herauszufinden, wie Sie in Microsoft Word, OpenOffice, LibreOffice oder einer anderen Textverarbeitung eine spezielle Einstellung ändern.

▶  Sie können viele Stunden damit verbringen, zu versuchen, Ihren Handbüchern ein professionelles Aussehen zu geben.

▶  Letztendlich erzielen Sie vielleicht ein professionelles Aussehen (oder das, was Sie dafür halten), aber Ihre optisch ansprechenden Handbücher sind schwer lesbar.

▶  Ihre Formatvorlagen arbeiten eventuell nicht so effizient, wie das möglich wäre. Ihre Benutzerhandbücher benötigen eventuell vor dem Veröffentlichen noch eine manuelle Feinformatierung.

Die professionell entwickelte Starter-Formatvorlage für Benutzerhandbücher hilft Ihnen, diese und viele weitere Fehler zu vermeiden. Die Formatvorlage basiert auf mehr als 25 Jahren Erfahrung in der Technischen Dokumentation und in der Entwicklung von Formatvorlagen für Benutzerhandbücher und Bedienungsanleitungen. Sie können die Formatvorlage für Benutzerhandbücher entweder direkt unverändert einsetzen, oder Sie können die Formatvorlage auf einfache Weise an Ihre unternehmensinternen Designvorgaben anpassen.

Die Starter-Formatvorlage für Benutzerhandbücher ist vollständig kompatibel mit Microsoft Word, OpenOffice und LibreOffice. In weiten Teilen funktioniert die Formatvorlage jedoch auch mit anderen Textverarbeitungsprogrammen und Autorensystemen, die Daten in den Formaten .DOCX oder .ODT lesen können.
Aufgeräumtes, klares Design erleichtert die Konzentration auf die Inhalte
Die Gestaltung der Formatvorlage ist bewusst schlicht gehalten. Leser eines Handbuchs möchten schnelle Antworten auf ihre Fragen. Sie haben wenig Interesse an grafischem Firlefanz.

Die Formatvorlage für Benutzerhandbücher verwendet ausschließlich grafische Elemente, die auch einen klaren praktischen Nutzen haben, und z. B. das Auge des Lesers an die richtigen Stellen leiten.
Design unterstützt punktuelles Lesen und Querlesen
Sehen Sie den Tatsachen ins Auge: Die meisten Leser werden Ihr Benutzerhandbuch nicht von vorne bis hinten durchlesen.

Die Gestaltung der Formatvorlage unterstützt die Leser beim Überfliegen und Querlesen Ihrer Bedienungsanleitung, um die benötigten Informationen gezielt zu finden. Ihre Kunden werden das zu schätzen wissen!
Gestaltung der Formate erleichtert die Orientierung im Text
Eines der schlimmsten Dinge, die Ihren Lesern in Ihrem Benutzerhandbuch passieren könnten, wäre es, die Orientierung zu verlieren. Die Leser würden dann die benötigten Informationen nicht finden und sich verloren führen. Beides sehr negative Erlebnisse.

Die Formatvorlage für Benutzerhandbücher wurde so gestaltet, dass Leser die Struktur einer Bedienungsanleitung stets rasch erfassen können: nicht nur im Inhaltsverzeichnis, sondern jederzeit auch mitten im Text.
Ausgewogener Anteil an Weißraum
Leerer Platz auf einer Seite ist nicht notwendigerweise verschenkter Platz. Der richtige Anteil an Weißraum an den richtigen Stellen eines Handbuchs kann das Augenmerk der Leser gezielt auf die relevanten Stellen lenken. Auch kann Weißraum dabei helfen, zusammengehörige Dinge visuell zu gruppieren.

Die Formatvorlage für Benutzerhandbücher setzt Weißraum gezielt und mit Bedacht ein.
Richtig gewählte Fonts und Font-Größen
Sie haben keine Probleme damit, in einer schicken kleinen Schriftart geschriebenen Text zu lesen? Seien Sie froh! Viele Menschen tun sich damit schwer.

Die Formatvorlage für Benutzerhandbücher verwendet Schriften, die einerseits groß genug sind, damit jeder den Text leicht lesen kann, die aber anderseits klein genug bleiben, um dennoch genug Informationen auf einer Seite unterzubringen.
Zeilenlängen, die das Lesen einfach machen
Wenn zu viele Buchstaben in einer Zeile eines Handbuchs stehen, findet das menschliche Auge beim Zeilenwechsel nur schwer den Beginn der richtigen neuen Zeile. Das ermüdet beim Lesen und erschwert unnötigerweise die Konzentration auf die Inhalte.

Die Formatvorlage für Benutzerhandbücher verwendet eine ausgewogene Zeilenlänge, die das Lesen einfach macht.
Semantische Formate
Die Formatvorlage für Benutzerhandbücher verwendet sogenannte semantische Formate. Dies bedeutet, dass die Formate nicht entsprechend ihres Aussehens benannt sind, sondern entsprechend ihres vorgesehenen Verwendungszwecks: der Semantik.

Beispiel: Ein Format, mit dem Sie den Namen einer Schaltfläche auszeichnen, heißt nicht „Arial10ptBold“, sondern „Button“. Wenn Sie z. B. eines Tages das Format von Arial 10 Punkt Fett ändern in Verdana 12 Punkt Blau Kursiv, können Sie dies tun, ohne ein neues Format anlegen und überall neu zuweisen zu müssen. Sie brauchen lediglich das Aussehen des bestehenden Formats zu ändern, aber nicht dessen Namen.
Benutzerfreundliche Namenskonventionen
Alle in der Formatvorlage für Benutzerhandbücher definierten Absatzformate und Zeichenformate sind entsprechend eines durchdachten einheitlichen Schemas benannt. Insbesondere sind die Formate so benannt, dass verwandte Formate immer zusammenstehend aufgelistet werden, wenn Sie in Ihrem Textverarbeitungsprogramm ein Format aus dem Formatekatalog auswählen.

Den am häufigsten benötigten Formaten sind in der Formatvorlage Tastenkürzel zugewiesen. Die Tastenkürzel verwenden einen Teil des Namensschemas, so dass Sie sich die Tastenkürzel leicht merken können.
Automatische Zeilenumbrüche und Seitenumbrüche
Die Formatvorlage für Benutzerhandbücher verwendet alle verfügbaren Layout-Automatismen. So können Sie sich vollständig auf das inhaltliche Schreiben Ihrer Handbücher konzentrieren und brauchen sich nicht darum zu kümmern, manuell irgendwelche Zeilenumbrüche und Seitenumbrüche zu setzen.

Jedes Format besitzt die optimalen Einstellungen zur Steuerung, ob ein Seitenumbruch den Absatz unterbrechen darf, ob ein bestimmter Absatz immer oben auf einer neuen Seite stehen soll, ob ein bestimmter Absatz immer zusammen mit einem anderen Absatz auf derselben Seite stehen soll usw.
Für internationalen Vertrieb druckbar sowohl auf A4-Papier als auch auf Letter-Papier
Mit der Formatvorlage formatierte Benutzerhandbücher lassen sich sowohl auf Papier im A4-Format ausdrucken als auch auf Papier im Letter-Format. Wenn Sie Ihre Bedienungsanleitungen in elektronischer Form ausliefern (z. B. als PDF-Datei), brauchen Sie daher für verschiedene internationale Märkte nicht unterschiedliche Versionen Ihrer Dokumente vorzusehen.

Falls Sie eine von A4 oder Letter abweichende Papiergröße benötigen, können Sie die Formatvorlage auf einfache Weise anpassen.
Leicht anpassbar
Die Starter-Formatvorlage enthält alle Elemente, die typischerweise in einer Bedienungsanleitung vorkommen. Sie können die Formatvorlage somit unmittelbar einsetzen.

Optional können Sie die Formatvorlage jederzeit anpassen, um Ihrem Handbuch ein unverkennbares Aussehen zu geben oder um das Design an die Corporate Identity Ihres Unternehmens anzupassen. Das Anpassen der bereits existierenden Formate erfordert im Normalfall nur Grundkenntnisse in Microsoft Word oder sonstigen Autorenwerkzeug.
Kostet nur 19,- € statt vieler Stunden mühevoller Kleinarbeit
Die Starter-Formatvorlage für Benutzerhandbücher kostet lediglich eine einmalige Gebühr von 19,- Euro. Vergleichen Sie diese Kosten selbst mit der Zeit, die Sie benötigen würden, eine vergleichbare Formatvorlage für Benutzerhandbücher von Grund auf selbst zu entwickeln!

Sie können basierend auf der Starter-Formatvorlage so viele Benutzerhandbücher erstellen, wie Sie möchten: ohne zusätzliche Lizenzkosten.
Kaufen

Verwenden Sie die Starter-Formatvorlage für Benutzerhandbücher, statt viele Stunden mit dem Anlegen einer eigenen Formatvorlage zu verschwenden.
Sie können die Starter-Formatvorlage für Benutzerhandbücher hier für nur 19,– € herunterladen.

Tipps zum Erstellen Ihrer eigenen Formatvorlagen für Benutzerhandbücher

Beachten Sie Ihre Zielgruppe



Entwerfen Sie kein Design, wie es Designern gefallen würde. Entwerfen Sie ein Design, das auf die Bedürfnisse Ihrer Zielgruppe passt.

  Wer sind Ihre Leser?

  Wo und unter welchen Bedingungen werden Ihre Leser Ihre Handbücher lesen?


Beispiele für
Anforderungen, die sich aus der Zielgruppe ergeben:

  Ältere Menschen benötigen eine größere Schriftgröße und mehr Abstand zwischen den Zeilen als jüngere Zielgruppen.

  Techniker bevorzugen im Allgemeinen ein schlichteres Design als Endverbraucher.

  Leser mit eher geringem Bildungsniveau benötigen eine klarere Führung als Hochschulabsolventen.


Beispiele für
Anforderungen, die sich daraus ergeben, wo und wie die Zielgruppe Ihre Handbücher liest:

  Leser in einer lauten Produktionshalle brauchen eine größere Schriftgröße und mehr Zeilenabstand als Leser in einem ruhigen Büro.

  Leser in einem fahrenden Auto, Bus, Zug, Flugzeug oder Schiff brauchen eine größere Schriftgröße und mehr Zeilenabstand als Leser in einer erschütterungsfreien Umgebung.

  Leser in direktem Sonnenlicht brauchen glanz- und spiegelfreie Seiten.

  Leser in Räumen mit schlechter Beleuchtung brauchen einen starken Kontrast zwischen Papier und Text sowie zwischen verschiedenen Farbtönen.

  Leser, die ein gedrucktes Handbuch mit sich führen müssen, brauchen möglicherweise ein Dokument in einem kleineren Seitenformat, das in ihre Tasche passt oder in ein speziell dafür vorgesehenes Fach am Produkt. Zum Beispiel sollte das Bordbuch eines Autos ins Handschuhfach passen.

  Leser eines elektronischen Benutzerhandbuchs auf einem Mobilgerät brauchen ein platzsparendes Layout auf kleinem Raum.


Halten Sie das Design einfach und übersichtlich



Weniger ist mehr. Halten Sie die Gestaltung der Formatvorlage für Ihre Bedienungsanleitungen so schlicht wie möglich. Lenken Sie die Leser nicht von den Inhalten ab. Erstellen Sie ein Design, das den Lesern dabei hilft, die im Handbuch gegebenen Informationen schnell zu finden und mit wenig Mühe aufzunehmen.


Vermeiden Sie überflüssige Vielfalt

  Verwenden Sie nur einige wenige Farben. Verwenden Sie unterschiedliche Farben nur dann, wenn diese einen bestimmten Zweck erfüllen. Reservieren Sie optisch hervorstechende Farben für besonders wichtige Dinge.

  Verwenden Sie nur wenige verschiedene Schriftarten und Schriftgrößen. Setzen Sie eine abweichende Schriftart oder Schriftgröße nur dann ein, wenn Sie damit einen klaren Zweck verfolgen. Reservieren Sie große und fette Schrift ausschließlich für besonders wichtige Informationen sowie für Überschriften.

  Versuchen Sie, mit möglichst wenigen Formaten auszukommen.

  Verwenden Sie dieselben Formate einheitlich im gesamten Handbuch.

  Verwenden Sie dieselben Formate auch in allen anderen Dokumenten zum Produkt: Montageanleitungen, Installationsanleitungen, Bedienungsanleitungen, Benutzerhandbücher, Referenzhandbücher, Betriebshandbücher, Wartungsanleitungen usw.

  Verwenden Sie beim Anordnen von Objekten immer dieselben Positionen. Richten Sie alle Objekte an einem einheitlichen Gestaltungsraster aus.


Vermeiden Sie Redundanz

Lassen Sie alles weg, was keinen wirklichen Nutzen besitzt: Buchstaben, Symbole, Linien, sonstige Objekte.

  Objekte, die wichtige oder hilfreiche Informationen vermitteln, sind nicht überflüssig.

  Objekte, die den Lesern dabei helfen, Informationen zu finden und zu verarbeiten, sind nicht überflüssig.

  Objekte, die nur dazu da sind, leeren Platz zu füllen, sind überflüssig!


Beispiele:

  Verzichten Sie auf Hintergrundbilder.

  Verzichten Sie darauf, Ihr Logo auf jede Seite zu setzen. Es genügt auf der Titelseite.

  Wiederholen Sie nicht auf jeder Seite den Namen des Autors.

  Wiederholen Sie nicht auf jeder Seite den Hinweis zum Copyright.

  Wiederholen Sie nicht auf jeder Seite Versionsnummer und Datum.

  Wiederholen Sie nicht auf jeder Seite den Dokumenttitel.

  Ein laufender Kolumnentitel mit der Überschrift des jeweils aktuellen Kapitels kann Lesern jedoch die Orientierung im Handbuch erleichtern und stellt damit einen wirklichen Mehrwert da.

Tipp: Manchmal erfordern es die Designvorgaben eines Unternehmens, dass bestimmte Elemente zwangsweise auf jeder Seite erscheinen müssen, egal ob dies nun Sinn macht oder nicht. Falls Sie in einem solchen Fall keine Einflussmöglichkeiten auf eine Änderung dieser Vorgaben haben (Sie sollten es zumindest versuchen), halten Sie die betreffenden Elemente so unauffällig wie möglich: verkleinern Sie die Elemente, verzichten Sie auf Farben, machen Sie Text hellgrau statt schwarz, positionieren Sie die Elemente an einem möglichst wenig beachteten Ort, klar abgegrenzt vom wirklichen Inhalt.



Vermeiden Sie Überfrachtung

Überfrachten Sie die Seiten Ihrer Benutzerhandbücher und Bedienungsanleitungen nicht mit einem Zuviel an Informationen. Setzen Sie gezielt Weißraum ein, um die Aufmerksamkeit der Leser zu steuern, um zusammengehörige Dinge zu gruppieren und um an den richtigen Stellen für Lese- und Atempausen zu sorgen.

Sollte durch ein aufgeräumtes Layout Ihr Benutzerhandbuch ein wenig länger werden, ist das kein Problem. Wenn Sie nützliche Inhalte bieten, sind Leser auch dazu bereit, am Bildschirm zu scrollen oder eine Seite umzublättern. Sie sind jedoch nicht dazu bereit, Handbücher zu lesen, die sie überfordern.


Sehen Sie semantische, am Inhalt orientierte Formate vor


Verwenden Sie Formatnamen, die die Bedeutung eines Formats beschreiben und nicht dessen Aussehen. Benennen Sie ein Format zum Beispiel „Betonung“ und nicht „Fett-Rot“.

Semantische Formate haben wesentliche Vorteile:

  Der Formatname zeigt Ihnen, wann Sie das Format sinnvollerweise einsetzen.

  Sie können das Erscheinungsbild des Formats jederzeit ohne negative Seiteneffekte ändern. Beispiel: Stellen Sie sich vor, Sie haben ein spezielles Format angelegt, das Sie immer dann verwenden, wenn der Name eines Bedienelements im Text vorkommt. Wenn Sie das Format zum Beispiel „Element“ genannt haben, können Sie später die Schrifteinstellungen jederzeit einfach ändern. Wenn Sie die Schriftart von Arial auf Verdana ändern möchten oder die Schriftgröße von 10pt auf 12pt, ist das kein Problem. Was wäre aber, wenn Sie Ihr Format “Arial-10pt-Fett” genannt hätten? Das würde jetzt nicht mehr viel Sinn ergeben …

  Semantische Formate sind eine der Grundvoraussetzungen für strukturiertes Schreiben in XML und DITA. Wenn Sie semantische Formate verwenden, sind Ihre Bedienungsanleitungen automatisch darauf vorbereitet, falls Sie eines Tages einmal zu einer strukturierten Texterfassung und -verarbeitung übergehen möchten.


Verwenden Sie eine durchdachte Namenskonvention

Um Ihre Handbuch-Formatvorlage möglichst anwendungsfreundlich für die Autoren zu machen, überlegen Sie sich ein effektives Benennungsschema für die Formatnamen:

  Wählen Sie Namen, die Sie sich leicht merken können.

  Wählen Sie die Namen so, dass verwandte Formate im Formatekatalog Ihres Autorenwerkzeugs zusammenstehend aufgelistet werden. Sie können dies erreichen, indem Sie die Namen verwandter Formate mit demselben Präfix beginnen.

  Wählen Sie für Tastenkürzel solche Tasten, die Sie sich leicht merken können. Verwenden Sie dasselbe Schema einheitlich für alle Absatzformate und ein anderes Schema einheitlich für alle Zeichenformate. Zum Beispiel könnten Sie für alle Absatzformate verwenden Alt+Umschalttaste+Buchstabe und für alle Zeichenformate Strg+Umschalttaste+Buchstabe.


Vermeiden Sie beim Schreiben amateurhafte Formatierungstechniken


Verzichten Sie auf:

  leere Absätze

  wiederholte Leerzeichen

  Tabulatoren

  alle Arten individueller lokaler Formatierung

Verwenden Sie ausschließlich die in Ihrer Formatvorlage definieren Formate!


Probleme mit leeren Absätzen

Verwenden Sie keine leeren Absätze, um den Abstand oberhalb oder unterhalb eines Absatzes zu vergrößern. Verwenden Sie stattdessen die dafür vorgesehenen Absatzeigenschaften.

Verwenden Sie leere Absätze außerdem nicht dazu, Seitenumbrüche zu erzeugen. Wenn Sie später einmal einzelne Zeilen zu Ihrem Benutzerhandbuch hinzufügen oder daraus löschen, rutscht sonst alles auf eine falsche Position. Verwenden Sie stattdessen immer manuelle Seitenumbrüche. Besser noch: Automatisieren Sie Seitenumbrüche nach Möglichkeit vollständig.

Alle Arten leerer Absätze führen zu Konflikten mit automatischen Seitenumbrüchen.


Probleme mit wiederholten Leerzeichen

Verwenden Sie keine Leerzeichen, um einen Text einzurücken. Definieren Sie stattdessen immer einen entsprechenden Einzug in den Absatzeigenschaften. Wenn Sie Leerzeichen zum Einrücken eines Absatzes verwenden, müssen Sie alle Folgezeilen manuell anpassen, sobald Sie etwas ändern.

In Online-Benutzerhandbüchern mit variabler Spaltenbreite funktionieren Einzüge mit Leerzeichen überhaupt nicht.

Die einzige Stelle, an der das Formatieren von Texten mit Leerzeichen in einem Benutzerhandbuch sinnvoll ist, sind Zitate von Programmcode. Wenn Sie über die Zwischenablage Programmcode in Ihr Handbuch einfügen, ist dieser typischerweise bereits mit Leerzeichen oder Tabulatoren eingerückt.


Probleme mit Tabulatoren

Vermeiden Sie das Verwenden der Tabulator-Taste. Tabulatoren können zu Problemen führen, wenn Sie ein Handbuch auch online verfügbar machen wollen, denn HTML kennt keine Tabulatoren. Tabulatorzeichen müssen dann in ein oder mehrere Leerzeichen oder in Einzüge umgewandelt werden, was nur selten sauber gelingt.

Anstelle von Tabulaturen verwenden Sie besser Absatzeinzüge oder eine Tabelle ohne Linien. Bedenken Sie: Selbst falls Sie heute noch keine Online-Version eines Benutzerhandbuchs bereitstellen möchten, sollten Sie sich diese Option für die Zukunft offenhalten.


Probleme mit lokaler Formatierung

Weisen Sie nicht manuell einzelnen Absätzen oder Zeichen Formateigenschaften zu. Verwenden Sie immer nur die in Ihrer Formatvorlage definierten Absatzformate und Zeichenformate. Wenn Sie ein Absatzformat für einen einzelnen Absatz manuell überschreiben, oder wenn Sie die Formatierung einzelner Zeichen manuell überschreiben, führt dies unweigerlich zu Problemen, wenn Sie später einmal das Design Ihres Benutzerhandbuchs ändern möchten. Dies mag Ihnen heute noch unwahrscheinlich erscheinen, passiert in der Praxis aber häufiger als gedacht.

Wenn Sie ausschließlich Formate der Formatvorlage verwendet haben und das Design ändern möchten, brauchen Sie lediglich in der Formatvorlage die Formatdefinitionen anzupassen und Ihr komplettes Handbuch erhält automatisch das neue Aussehen. Wenn Sie jedoch manuelle Formatierungen verwendet haben, müssen Sie diese alle einzeln von Hand anpassen. Bei mehreren Handbüchern, vielleicht sogar noch in mehreren Sprachen, kann das schnell viele Stunden zusätzlicher Arbeit bedeuten.
Möchten Sie viel Zeit sparen und mögliche strategische Fehler vermeiden?

Die Starter-Formatvorlage für Benutzerhandbücher hilft Ihnen dabei.