Welche Software um ein Handbuch zu erstellen?

[TigerLilly]

Zitat von Codehunter:

Doc-o-Matic dürfte hier nicht ganz das richtige sein, das hat seinen Schwerpunkt auf der Quellcode-Dokumentation, hier geht es aber um eine Anwender-Dokumentation.

Wenn du dir nicht sicher bist, schau doch nach.

Doc-O-Matic ist hier definitiv richtig. Die Author(!)-Edition ist für Anwender(!)-Dokumentation aka Hilfe/PDF/HTML gedacht.

[Uwe Raabe]

Zitat von TigerLilly:

Doc-O-Matic ist hier definitiv richtig. Die Author(!)-Edition ist für Anwender(!)-Dokumentation aka Hilfe/PDF/HTML gedacht.

Das ist schon richtig. Ich hatte früher beide System (Doc-O-Matic und H&M) im Einsatz, wollte mich dann aber für eines der beiden entscheiden. Doc-O-Matic hat (zumindest damals) seine Stärken eindeutig in der Programmdokumentation, während H&M in der Anwendungsdokumentation punkten konnte. Trotzdem habe ich ein paar brauchbare Handbücher auch mit Doc-O-Matic erstellt.

Mit dem Erscheinen von Documentation Insight verschob sich der Nutzen allerdings schnell in Richtung DocInsight mit H&M. Damit bleibt Doc-O-Matic aber trotzdem noch ein brauchbares Tool für beide Dokumentationsarten.

Zwischenzeitlich schien mir die Entwicklung von Doc-O-Matic auch etwas eingeschlafen. Es freut mich, daß mit der aktuellen Version 10 das Tool nun wieder in der oberen Liga mitspielt.

[Codehunter]

Scheint so als war es eine gute Idee, mal nach den verschiedenen Lösungen zu fragen. Doc-o-Matic ist mir seit langem bekannt, jedoch nie als Autoringlösung aufgefallen. Ich werde mal ein Lastenheft erstellen und schauen welche der hier vorgeschlagenen Lösungen am besten passt.

[TigerLilly]

Was mir an DOM so gut gefallen hat, war dass man sehr frei im Verfassen der Texte ist. Unsere Rohdaten für die Hilfe/Pdf/HTML sind viele einzelne zT generierte Textdateien, die auch super einzeln unter Versionskontrolle gestellt werden können. Dem Parser von DOM sagt man dann, was wie behandelt werden soll.