Software um Doku´s zu erstellen

[felkr 11]

Hi Leute,

 

Ich wollte mal fragen ob Ihr mir ein gutes Doku Tool empfehlen könnt.

 

Folgendes Szenario:

 

Unsere Firma schreibt Ihre Software selbst. Wir führen zahlreiche Updates bei unseren Kunden durch. Zu diesen Updates gibt es auch Updatebeschreibungen. Und genau um diese geht es.

Bis jetzt erstelle ich jeden Monat ein neues Doc Dokument, das ich dann per PDF an die Kunden verschicke. Das ist aber leider eine nicht so gute Lösung.

Ich bräuchte eine Software, wo ich immer einzelne Bereiche schreiben kann. Diese einzelnen Bereiche kann ich dann zu einem Dokument zusammen klicken und versenden.

Ich habe ja verschiedene Programm Parts und nicht jeder Kunden nutzt jeden Programm Part.

Oder es wird immer nur nach Bedarf geupdatet. Daher kann es sein das ein Kunde viel mehr Infos kriegt als der andere.

Was ist nach eurer meinung nach eine elgeante Lösung für eine Updatebeschreibung und Doku? Wie schreibt ihr die Handbücher?

 

Bin für jede Hilfe dankbar.

 

Mfg

 

felkr

[Finanzamt 73]

Hi!

M.E. ist die .PDF - Lösung sehr kundenfreundlich. Und daß eine Kunde mehr .PDFs bekommt, als er mit Blick auf die installierten Sachen braucht, ist angesichts der üblichen .PDF-Größe und Speicherkapazitäten nicht wirklich ein Problem.

Das Problem besteht in der passenden Selektion. Ich habe mir dazu mal ein Tool geschrieben. Es besteht aus einem .TXT - File, bei dem die ersten Zeichen 1-39 für eine Inhaltsangabe, 40-99 für die Pfadangabe zum Dokument ab aktuellem Verzeichnis und 100 ff. für den vollqualifizierten Pfad des Programmes reserviert sind, mit dem das Dokument geöffnet werden soll/muß. Letzteres reduziert sich auf den .EXE - Namen, wenn der Dateityp registriert oder die Programm-EXE im Pfad stehen.

Der User browst durch die Liste (Z.1-40, Inhaltsangabe) und klickt auf einen Anzeige-Button, wenn er die Sache lesen will.

Im Prinzip werden aus dem .TXT - File nur die jeweils benötigten Teile zu einem String zusammengeschnipselt und im Browser dargestellt bzw. mit ShellExecute() verbunden über den Button ausgelöst. Habe das in Delphi gemacht; in anderen Sprachen sollte es auch problemlos und schnell gehen.

Diese .TXT - Steuerdatei läßt sich recht bequem editieren. Eine automatische Alternative setzte voraus, daß Ihr Eure (Update- und) Programminstallationen in HKLM\Software\EuerFirmenname\... protokolliert. In beiden Fällen ist das Ziel halt, nur zu den installierten Teilen Infos anzubieten.

Gegrüßt!