Technische Dokumentation im Wandel

Autor: Prof. Sissi Closs
Eingetragen seit: 07/2006
Letzter Beitrag: 04/2009
Beiträge insgesamt: 7
Expertenprofil   Alle Experten   

DruckversionAls E-Mail versendenZum Magazin-Forum

Viele Unternehmen sehen Dokumentation nur als Kostenfaktor. Das kommt nicht von ungefähr. Obwohl die Produktinformationen in den Firmennetzen vorhanden sind und die Dokumente überwiegend elektronisch erstellt werden, bleiben die Daten in weiten Teilen des Produktlebenszyklus ungenutzt und müssen immer wieder neu recherchiert, erfasst, aufbereitet, gepflegt, übersetzt, geprüft und passend zusammengestellt werden.

Technische Dokumentation liefert, wie der Name schon sagt, Information vorwiegend zu technischen Produkten. Sie hat die Aufgabe, das Produkt für die Zielgruppe verständlich zu machen und zugleich die Informationen bedarfsgerecht zu präsentieren.

Entstanden zu einer Zeit, als es nur die Papierdokumentation gab, hat sich die Technische Dokumentation an den etablierten Büchern orientiert und diese entsprechend ihren Anforderungen präzisiert. Bedienungsanleitung, Wartungshandbuch, Installationsanleitung sind typische Beispiele. Dieses Buch-Modell hat weitreichende Auswirkungen.

Es bestimmt die Geschäftsprozesse mit ihren Aufgabenbereichen und Rollen sowie die Tool-Landschaft, die diese Prozesse unterstützt. Insbesondere hat es dazu geführt, dass für die Technische Dokumentation eigene Werkzeuge zur Unterstützung der dokumentbezogenen Prozesse entwickelt wurden: Autorenwerkzeuge für die Dokumenterstellung, Tools für die Publikation und Tools für die Dokumentverwaltung.

Als elektronisches Abbild einer Bibliothek dienen letztere dazu, fertige Dokumente abzulegen und mit Metadaten zu versehen, um das Wiederauffinden zu erleichtern. Die heute etablierten Prozesse und Tools sind viele Jahre erprobt und waren lange Zeit Garant für effiziente Abläufe und zuverlässige Dokumentation.


Web-Nutzung verändert klassisches Dokumentenmodell

Aber technische Neuerungen und die damit verbundenen Veränderungen erfordern naturgemäß Anpassungen am gewohnten Vorgehen. Spätestens seit das Web Informationsangebot und -nutzung so dramatisch verändert hat, reicht das klassische Dokumentmodell nicht mehr aus.

Die elektronische Welt ermöglicht die Erstellung von immer neuen Informationsgebilden, die wenig oder gar nichts mehr mit einem klassischen Dokument zu tun haben. Das herkömmliche Dokumentbild löst sich auf. Inhalte sind nicht mehr Teil einer statischen, physisch fassbaren Einheit, sondern Knoten in einem weit verzweigten dynamischen Netz aus Inhaltsbausteinen und Links, die sich unterschiedlich darstellen, abhängig davon, wer sie zu welchem Zeitpunkt und in welchem Zusammenhang verwendet.

Dafür aber gibt es keine so ausgereiften Modelle wie in der Papierwelt und es mangelt an Erfahrung in der Handhabung. Verständlich daher, dass die Werkzeuge, die zur Unterstützung der modularen Informationsgebilde entwickelt werden, noch Versuchscharakter haben. Sie sind immer noch auf die herkömmlichen Rollen und Aufgabenverteilung ausgerichtet, zu spezifisch, um firmenweit eingesetzt werden zu können.

Die verschiedenen Bereiche haben ihre eigenen Systeme, die auf die Anforderungen des jeweiligen Bereichs zugeschnitten sind und ein spezielles Bedien-Know-how erfordern. Das Marketing kann nichts mit Entwicklungsumgebungen anfangen, die Entwicklung nichts mit grafischen Gestaltungstools. Darüber hinaus sind die Systeme so teuer, dass sie nur da installiert werden, wo sie am dringendsten benötigt werden.

Daten, die bereichsübergreifend in einer Firma und erst recht über Firmengrenzen hinweg benötigt werden, werden also auf andere Weise ausgetauscht, bevorzugt auf Papier oder per E-Mail. Damit verlassen sie die Ursprungsumgebung und werden in vielen unterschiedlichen Systemen gehalten.

Gleichzeitig aber wächst der Druck, Inhalte immer schneller zu aktualisieren und verfügbar zu machen. Wir müssen uns daher darauf einstellen, die gewohnten Verfahren komplett über Bord zu werfen und neue Modelle und Verfahren zu definieren. Dabei sind wir gut beraten, wenn wir nicht nur die etablierten Bereiche isoliert voneinander betrachten, sondern versuchen, Synergien durch bereichsübergreifende Lösungen zu schaffen.


Von der Produktdokumentation zum zentralen Inhaltspool

Betrachten wir zum Beispiel die Fehlermeldungen zu einem Produkt. Sie werden nach herkömmlichen Verfahren in mehreren Geschäftsbereichen (Entwicklung, Dokumentation, Support, ...) an vielen Stellen beschrieben, gepflegt und verwaltet – mit der Konsequenz, dass die Prozesse aufwändig und die Ergebnisse fehlerhaft sind.

Die Umstellung auf einen zentralen Meldungspool, in dem jede Fehlermeldung nur einmal vorhanden ist, aber von unterschiedlichen Leuten gepflegt und für verschiedenste Zwecke genutzt werden kann, kann mühsame und fehleranfällige Übergabe, Abstimmung und Überprüfung überflüssig machen.

Das zeigt, dass die herkömmliche Produktdokumentation in Form von statischen buchartigen Dokumenten zumindest teilweise in Frage gestellt werden muss. Statt viel Aufwand in die Dokumentation zu stecken und dabei Gefahr zu laufen, Dinge aufzuschreiben, die niemanden interessieren oder die keiner versteht, müssen Wege gefunden werden, flexibel und schnell nach Bedarf eine gemeinsame Basis für den Informationsaustausch zu schaffen.

Die modulare, topicorientierte Strukturierung eignet sich hervorragend für die Organisation der Inhalte eines zentralen Inhaltspools.

Methoden wie die Klassenkonzept-Technik helfen, einen passenden Strukturierungsrahmen für Inhalte beliebiger Größe und Komplexität effizient und flexibel aufzubauen. Dieser Rahmen hilft, Modelle für Informationsgebilde zu finden, die als Vorgabe für die Erstellungsseite und als Gerüst für die Nutzungsseite dienen können. Gleichzeitig ist er flexibel und erlaubt eine schnelle Anpassung, wenn die Modelle geändert werden müssen, weil sie noch nicht oder nicht mehr insbesondere auf Grund neuer technischer Entwicklungen passen.


Aufgaben, Zuständigkeiten und Prozesse neu definieren

Für die neuen Modelle müssen auch die Aufgaben, Zuständigkeiten und Prozesse neu definiert werden. Im herkömmlichen Dokumentationsprozess entwerfen nur einige wenige die Inhalte, die für alle Nutzer interessant, wichtig und passend sein sollen. Das funktioniert nicht, wie die Praxis zeigt.

Erst die Aufhebung der strikten Trennung zwischen Autor und Leser bzw. Produzent und Konsument wird Inhalte schaffen, die der Funktion, Erfahrung und Aufgabe der Zielgruppe gerecht werden und in einer passenden Sprache verfasst sind. Insbesondere die zukünftigen Nutzer der Dokumentation sollen sich in den Dokumentationsentwicklungsprozess einschalten.

Erfahrene Nutzer sind die eigentlichen Wissensträger. Sie können viel eher die richtig interessanten Informationen liefern als einsame Redakteure, die sich nur imaginär in die Nutzerwelt versetzen. Statt einseitiger Kommunikationswege und Informationsflüsse steht das Einbeziehen vieler Beteiligter im Vordergrund, um vom Wissen der Anderen zu profitieren und insgesamt schneller zum Ziel zu kommen.

Bei der Gestaltung des Miteinander fehlt es allerdings noch an Erfahrung. Einerseits müssen die alten Rollen und Aufgabenverteilungen aufgebrochen werden, andererseits müssen neue Zuständigkeiten geschaffen werden, um sicherzustellen, dass der gemeinsame Informationspool in geordneten Bahnen wachsen kann, und um chaotische Auswüchse zu verhindern.

Herkömmliche Tools unterstützen diese Art der Zusammenarbeit nicht ausreichend. Kollaborationsplattformen wie Wikis sind in dieser Hinsicht flexibler. Statt einer starren Ablagestruktur lassen sich unterschiedliche Sichten auf die Inhalte darstellen, die Art und der Umfang der Beteiligung kann nach Kenntnisstand und Bedarf geregelt werden. Auch eine kurzfristige, temporäre Mitarbeit ist problemlos möglich.

Aber hier fehlen noch viele wichtige Funktionen für die Sicherheit, die Automatisierung, die Ausgabe in unterschiedliche Medien, die in herkömmlichen dokumentzentrierten Verwaltungssystemen ausgereift zur Verfügung stehen.

Es bleibt also weiterhin spannend.


04/2009, Prof. Sissi Closs





Prof. Sissi Closs gehört zu den führenden Experten für Online-Dokumentation und XML in Deutschland. Sie ist Mitinhaberin und Geschäftsführerin der Firmen Comet Computer und Comet Communication.
Alle Experten   
Publizieren Sie Ihren eigenen Fachbeitrag   

Mehr Informationen zu diesem Thema im Buch
Single Source Publishing – Topicorientierte Strukturierung und DITA


Kommentare zu diesem Beitrag 


Schreiben Sie einen Kommentar zu diesem Beitrag

Newsletter abonnieren

Verpassen Sie nichts und bleiben Sie informiert mit unserem Newsletter.
Ihre E-Mail Adresse:  
RSS-Feed: Alle News aktuellUnsere News auf Ihrer Website

Weitere Beiträge zu diesem Thema

Spart bares Geld: Elektronische Personalakten
In vielen Personalabteilungen wird auch heute noch gedruckt, kopiert und abgeheftet. Dabei bringt die elektronische Aktenführung nicht nur klar kalkulierbare Kostenvorteile...
Wie kommt ECM zum Kunden?
Ziel dieses Artikels ist, anhand eines groben Projektvorgehens die typischen Aktivitäten und Problemfelder in ECM-Vorhaben aufzuzeigen und somit zu einer Qualitätsverbesserung beizutragen...
Fragen und Antworten zur elektronischen Rechnung
Der Steuergesetzgeber stellt besondere Anforderungen an den elektronischen Rechnungsversand. Bei diesem Fragen- und Antwortenkatalog handelt es sich um eine Orientierungshilfe für Unternehmen...
Praxis: Dokumentenmanagement frei von Risiken und Nebenwirkungen – fragen Sie Ihre Apotheke
Mit dem DMS ELOprofessional hat die Gustav-Adolf Apotheke ihre Verwaltungsarbeit drastisch minimiert und kann jetzt die neu gewonnene Zeit im Kundenservice einsetzen...
Technisch-funktionale Stolpersteine bei der E-Mail-Archivierung
Zunehmend wird klar, dass das Thema Mail-Archivierung ganz eigene Stolpersteine funktionaler und technischer Natur hat, die die Anwender häufig erst kennen lernen, wenn es zu spät ist. Mail ist eben nicht nur eine andere Dokumentart...

Beiträge aus anderen Themenbereichen

VOICE Days plus: Deutschlands Servicewelt im Fokus
Im Interview spricht der Schirmherr der Initiative Prof. Dieter Spath über "Das Konstruktionsbüro für Dienstleistungen" und vieles mehr. Am 12. Oktober eröffnet Prof. Dieter Spath den VOICE Days plus Kongress...
eCommerce & Datenschutz - Das sollten Sie wissen
Datenschutz spielt auch im eCommerce eine große Rolle. So müssen z.B. für den Betrieb eines Onlineshops die gesetzlichen Vorschriften zum Datenschutz eingehalten werden...
Schritt halten in der IT-Security – Die Karriere vorantreiben
Um 1995 steckte die IT-Sicherheitsbranche noch in den Kinderschuhen. Die meisten, die sich damals dafür entschieden haben, ihren beruflichen Fokus auf die IT-Security zu setzen, kamen aus der IT...

Sponsored Links

Swinger Paare
Das Content Management PortalDas Dokumenten Management PortalDas IT-Security PortalDas Customer Relationship Management PortalDas E-Commerce PortalDas Enterprise Resource Planning PortalPortal für VoIP und mobile KommunikationDas Magazin für IT im KrankenhausDas Verzeichnis für IT-Profis
homeimpressumerklärung zum datenschutz - privacy policykontaktwerbung

Schnellsuche




Der IT-Service-Finder


Auf der Suche nach dem besten IT-Dienstleister? Hier werden Sie fündig! Bereits 1.840 Unternehmen aus 17 Ländern.

Zu den IT-Profis...


Documanager.de weiterempfehlen


Senden Sie Freunden und Bekannten einen Hinweis auf Documanager.de!



Aktueller Buchtipp


Datenflut - Fluch oder Segen?