Lauf, Forrest, lauf!

Text: Johannes Schäfer

Die Technische Dokumentation mit Open-Source-Anwendungen muss keine komplizierte Angelegenheit sein. Apache Forrest ist eine dieser Anwendungen, die sich zum Beispiel für die Publikation umfangreicher Dokumente nach dem Single-Source-Prinzip eignen. Dieser Beitrag beschreibt die Nutzung anhand der Erfahrungen der „User Interface Design GmbH“ bei der Erstellung von User-Interface-Styleguides und -Spezifikationen.

Inhaltsübersicht

Lesedauer: 07:11 Minuten

Für unsere Kunden erstellen wir immer wieder Spezifikationen und Styleguides für Nutzungsschnittstellen. Mit dem Einsatz von Microsoft Word stießen wir dabei an die Grenzen des Machbaren, als unsere Kunden neben einer „Druckversion“ zunehmend eine Version für das Intranet zum Online-Zugriff verwenden wollten. Außerdem wuchsen sowohl der Umfang der Dokumente (inzwischen bis zu 1.000 Seiten) als auch die Anzahl der Autoren (bis zu zehn gleichzeitig). So sind wir 2004 auf Apache Forrest [1] gestoßen. Inzwischen setzen wir die Anwendung in vielen Projekten ein, haben Anpassungen und Erweiterungen vorgenommen, ich selbst bin in den engeren Entwicklerkreis aufgenommen worden.

Apache Forrest installieren

Es muss nicht schwierig sein, ein Publikationssystem aufzusetzen. Bei Forrest genügt es, die letzte Version herunterzuladen [2] und auszupacken. Einzige Voraussetzung ist eine vorhandene ...