Oct
05
2009
1

Technische Dokumentation 2.0 – Teil 1: XML statt Word

Wie schon im letzten Beitrag angekündigt, möchte ich die einzelnen Schritte, die bei der Umstrukturierung des Dokumentationsprozesses durchgeführt wurden näher beschreiben. Im ersten Teil geht es um die Umstellung des Basisformates von Word auf XML. Zunächst eine kurze Beschreibung des Dokumentationsprozesses vor der Umstellung auf XML: (more…)

Post to Twitter Post to Delicious Post to Digg Post to Facebook Post to MySpace

Written by Karsten Krumrück in: company,deutsch,general | Tags: , ,
Sep
21
2009
2

Technische Dokumentation 2.0

Heute leben wir in Zeiten, in denen das Internet allgegenwärtig ist und man zuerst bei Google und Wikipedia nachschlägt, wenn man etwas wissen will. Diesem Umstand muss auch die technische Dokumentation von Software Rechnung tragen. Vorbei sind die Zeiten, als dicke schwergewichtige Folianten ausgeliefert wurden, durch die man sich mühsam hindurcharbeiten musste, um die richtigen Informationen zu finden. In der Dokumentationsabteilung von Saperion wurde in den letzten Jahren daher eine grundlegende Umstrukturierung des Dokumentationsprozesses vollzogen.

Heute basiert der Dokumentationsprozess von Saperion auf drei Säulen:

  • Docbook XML als Basisformat
  • Internes Wiki für die Zusammenarbeit mit Entwicklern und als Systemdokumentation
  • Online Portal für die Recherche in der Dokumentation

Bis zu diesem Stand des Dokumentationprozesses war es ein langer und schwieriger Weg, der in den nächsten Wochen hier beschrieben werden soll. Im einzelnen umfasste die Umstrukturierung des Dokumentationsprozesses diese Etappen:

  1. XML statt Word
  2. Wiki statt Mail Ping Pong
  3. Dokumentationsportal statt Handbuchstapel

Post to Twitter Post to Delicious Post to Digg Post to Facebook Post to MySpace

Written by Karsten Krumrück in: company,deutsch | Tags: , ,

Theme: TheBuckmaker.com Web Templates | Bankwechsel Umschuldung, Iplexx IT Solutions