Für die Entwickler, die ihren Quellcode dokumentieren wollen, werfe ich noch
NDoc in den Raum. Wie ich in der Shoutbox gelesen habe, soll LaTex das auch können.
Und bei
FAR bin ich nicht sicher. CHMs kann es auf jeden Fall erzeugen. HxS-en vllt. auch, aber ich weiß es nicht, weil ich mir das Programm nicht angeschaut habe.
Ansonsten stellt Microsoft auch kostenlose Tools zur Verfügung. Wer das Visual Studio .NET besitzt, kann diese Hilfedateien sogar bequem per
IDE erstellen. Wer das Visual Studio nicht besitzt, kann (mit einem kleinen Kniff, s. Helpware-Homepage) immerhin die Kommandozeilentools benutzen.
Ich persönlich hatte damit keine großen Probleme, weil ich so mit meinen bevorzugten Editoren arbeiten konnte (Projektdateien sind
XML, Inhalt ist nach wie vor
HTML usw.). Für den Build-Lauf habe ich ein VB-Skript, das mir die Hilfedateien der Reihe nach kompiliert. Und das Ergebnis
(die HxS-Version von Luckies Win32-API-Tutorials) kann sich
IMHO sehen lassen.
Noch einfacher wird es, wenn man seine Dokumentation bereits im CHM-Format vorliegen hat. Hier hilft der Konverter (auch bei den o.g. kostenlosen Microsoft-Tools dabei) weiter, der daraus eine HxS-Hilfedatei bzw. HxS-Projektdateien erzeugen kann.
Ich hätte da auch noch eine selbst geschriebene Doku anzubieten, die es immerhin als externer Link auf die deutsche Seite von help-info.de geschafft hat. 8)