19.07.05 Technische Dokumentation mit Apache Forrest

Skript und Material zum Vortrag [PDF 720 KB]

Styleguides und andere Technische Dokumente stellen uns vor immer mehr Herausforderungen:
- Mehrere Personen arbeiten an demselben Dokument: Usability-Experten, Designer, technische Autoren, Entwickler, ...
- Die Leser erwarten ein Dokument im Intranet: immer aktuell, leicht verfügbar, hübsch "gestyled" und "usable".
- Es ist eine (identische) Druckversion/PDF nötig, die in Datenbanken abgelegt wird.

Mit Apache Forrest (forrest.apache.org) steht ein freies Publikationswerkzeug zur Verfügung, das einen hierbei unterstützt. Basierend auf Standards wie XML und HTML, kann mit Forrest aus verschiedenen Quelldokumenten (z.B. XML, DocBook, OpenOffice) eine einheitliche Ausgabe (z.B. in HTML und PDF) erzeugt werden.

Im Vortrag stelle ich Apache Forrest vor und berichte über unsere Erfahrungen beim Schreiben von Styleguides.
- Was ist Forrest und wie funktioniert es? Vor-/Nachteile.
- Wie schreibt man die Inhalte?
- Wie kann ich bestehende Dokumente übernehmen?
- Wie kann man komplexe Dokumente strukturieren?
- Wie kann man das Erscheinungsbild dem Kunden anpassen?

Johannes Schäfer
Johannes Schäfer studierte Informatik an der Universität Karlsruhe (Diplom 1994) und Psychologie an der TU Dresden (Diplom 1999). Vor seiner Tätigkeit bei UID arbeitete er als freiberuflicher Usability-Berater und war davor bei der IBM Deutschland Entwicklung GmbH in Böblingen für internationale Projekte als User-Centered Design Consultant verantwortlich und stellvertretender Leiter des dortigen Usability-Labors. Weitere Erfahrung sammelte er am Media Design Center der TU Dresden, das er als Projektleiter aufbauen half. Des Weiteren hat er Erfahrungen in der experimentellen Psychologie und als System-Architekt und Programmierer.

Johannes Schäfer hält derzeit an der Fachhochschule Heilbronn die Vorlesung "Software-Ergonomie". Er ist Mitglied des German Chapters der Usability Professionals' Association e.V. (GC-UPA), dem Berufsverband der deutschen Usability Profis.

zurück zum Programm 2005