tekom-Jahrestagung 2012 - ActiveDoc

Content Management
CM 7
Workshop
Module al gusto – Dokumente
maßgeschneidert modularisieren
Ute Mitschke, Ovidius GmbH, Berlin
Beim Aufbau modularer Dokumentation wird großer Wert auf die Auswahl
einer geeigneten XML-Struktur gelegt. Wiederverwendung von
Inhalten und Effizienz des Systems beim Publizieren werden gleichzeitig
durch die Klassifizierung der Inhalte und Vereinbarungen zur Modulgröße
beeinflusst.
Wird ein Content-Management-System (CMS) eingeführt, entstehen
Module mit den unterschiedlichsten Inhalten, die vom Redakteur bei
der Arbeit mit dem CMS leicht gefunden, eindeutig identifiziert und im
gewünschten Kontext zusammengestellt werden müssen.
Was ist das Schwierige am Finden einer effektiven Benennung für Module?
Es ist der Wunsch, mit ständig wechselnden Suchkriterien das
Modul über die Benennung aus einer nicht mehr überschaubaren Vielzahl
wiederfinden zu können.
Wer sucht, der findet?
Folgende Szenarien sind vorstellbar:
1. Jemand sucht alle Module, in denen das Wort „Schraubenzieher“ vorkommt.
2. Es soll ein Modul gefunden werden, in dem die Reinigung eines Filters
von Ölresten beschrieben wird.
3. Die Anleitung für Produkt 1 muss überarbeitet werden, da es eine
funktionale Änderung gibt, die nur Produkt 1 betrifft. Wie müssen die
Module gekennzeichnet werden, damit nur die Module von Produkt 1
und nur die aus den Kapiteln Inbetriebnahme und Bedienung gefunden
werden?
4. Es soll ermittelt werden, ob es Module gibt, für die ein konkreter Autor
Inhalte für Service-Handbücher verfasst hat.
5. Die Anleitungen von Produkten, die im kommenden Monat auf den
Markt gehen sollen, müssen um einen Sicherheitshinweis für die
Betriebssicherheit ergänzt werden. Davon betroffen sind nur die
Produkte einer Produktklasse und nur die Abschnitte für das Kapitel
Bedienung. Wie müssen die Module gekennzeichnet worden sein,
damit konkret diese Module leicht gefunden werden?
Die Beispiele zeigen, dass es empfehlenswert ist, in der Konfiguration
des CMS die Möglichkeit vorzusehen, Module mit ausreichend vielen
Metadaten auszuzeichnen, um mit deren Hilfe gezielt nach ihnen suchen
zu können. Durch jedes Metadatum wird dabei eine bestimmte
Perspektive definiert, nach der gesucht werden kann.
tekom-Jahrestagung 2012
47