Mythos „Tabellen- oder Abbildungsverzeichnisse bringen Nutzen“

Es ist mit aktueller Software relativ einfach, beliebige Verzeichnisse und Indizes zu generieren. Dies ist meiner Ansicht nach auch der Grund, warum Tabellen- und Abbildungsverzeichnisse in der Technischen Dokumentation so weit verbreitet sind.

Mythos „XML taugt nicht für Tabellen“

Sehr häufig sagen Leute, sie könnten eine Tabelle nicht mit XML. Dies ist unabhängig vom Publikationswerkzeug, ob es sich nun um FrameMaker, Epic oder XSL-FO handelt. Beim Anschauen der Tabellen bin ich auf verschiedene Problemkategorien gestoßen.

Mythos „Rechtssichere Dokumentation“

Ich höre immer wieder die Frage, wie man in einer technischen Dokumentation das Kapitel "Allgemeine Sicherheitshinweise" gestalten müsse, damit man eine "rechtssichere Dokumentation" erhält. Doch kann es so etwas überhaupt geben?

Mythos „Abbildungen benötigen Titel“

Es hat bei mir relativ lange gedauert, bis ich verstanden habe, dass Titel für Abbildungen in der Technischen Dokumentation meist unnötiger Ballast sind. Ich war zu stark geprägt von den Lehrbüchern, die brav jede Abbildung mit einem Titel versehen.

Mythos „Automatischer Seitenumbruch taugt nichts“ (2)

Automatische Seitenumbrüche sind sicher nicht optimal, aber je nach Umfang des Dokuments sinnvoll. Diese Layouteinstellungen sollten Sie für einen automatischen Seitenumbruch einsetzen.

Mythos „Automatischer Seitenumbruch taugt nichts“ (1)

Was man für einen guten automatischen Seitenumbruch tun kann, erklärt Jürgen Schurr aus der Technischen Dokumentation der TANNER AG im ersten Teil des Blogartikels.

Mythos „Manuelles Ändern des Seitenumbruchs ist notwendig“

Jürgen Schnurr arbeitet in der Technischen Dokumentation bei TANNER. Er hat viele Layouts mit dem strukturierten FrameMaker oder dem Arbortext Editor umgesetzt. Seiner Erfahrung nach ist ein manuelles Ändern von Seitenumbrüchen bei guten Layouts nur in seltenen Ausnahmefällen erforderlich.