Dokumentationssoftware

[axors]

Hi Forum Community,

ich suche ein Programm/ Tool mit dem man Dokumentationen erstellt. Es gibt hier einige, wie ich schon durch Google erfahren habe.
z.B. Latex, Adobe RoboHelp und dergleichen.

Leider passen die nicht so richtig für meinen Zweck.

das Tool soll folgendes können:
- einmal eine CI einstellen und wenn ein .pdf erstellt wird, soll der Kopf und Fuss automatisch erstellt werden
- Man soll entweder das Programm z.B. über den Browser aufrufen können oder lokal installiert haben, beides ist möglich
- es soll aus dem Tool heraus die Möglichkeit geben, einen Screenshot von einer laufenden Anwendung zu machen und dort dann auch einen Rahmen zu ziehen, bzw. diverse Inhalte zu markieren (Rahmen ziehen, Mauszeiger, Kommentare einfügen).
- optimal wäre auch z.B. Visio-like Prozesse abzubilden und dann per Klick auf den Prozess in eine Doku zu kommen
- Das Tool soll ähnlich wie Word funktionieren, also die Basisfunktionen sollen selbst erklärend sein, da auch technisch unversierte damit arbeiten sollen
- Kurz gesagt: eine Eierlegendewollmilchsau im Bereich Dokumentationserstellung.

Habt ihr solche Tools im Einsatz? Bzw. was verwendet ihr? Funktion steht im Moment vor Preis. Eine Testversion wäre aber von Vorteil.

Vielen Dank.

[Atomschwammerl]

Wie viele Seiten hat eine durchschnittliche Dokumentation?
Wie viele Dokumentationen erstellst du pro Tag? (Automatisierung)

Was mir auf die schnelle einfällt:

• MS Word
  Man kann darin auch Drawing wie mit Visio Machen, Screenshots copy und Paste, Sowie Format Vorlagen
• Latex
  Für Größere Dokumentationen ab 50 Seiten zu bevorzugen, Gut automatisierbar, Open Source
• Framemaker
  Auch automatisierbar, XML Format

[axors]

Die Dokumentation kann von 100 - 500 Seiten haben.
Es soll keine tägliche erstellt werden, sondern quasi pro Abteilung 1 Dokument, dass laufend gepflegt werden soll.

Word wird zum Teil verwendet, ist aber für Screenshots nicht die beste Lösung und bei vielen Seiten wird auch Word unperformant.

Auf Latex hab ich schon einen Blick drauf geworfen, nach meiner ersten Meinung erscheint mir das aber für den 0815-User zu umständlich.

Framemaker werd ich mir mal anschaun.

[Thiersee]

- Das Tool soll ähnlich wie Word funktionieren, also die Basisfunktionen sollen selbst erklärend sein, da auch technisch unversierte damit arbeiten sollen

Aus diesem Grund scheidet m.E. LaTeX aus!

Mit Word kannst du einigermaßen laufend sehen, wie das Dokument am Ende ausschauen wird (WYGIWYS).

Mit LaTeX (eigentlich eine mächtige Programmiersprache, die man erlernen muß!) musst du zuerst verschiedene "Module" in der richtigen Reihenfolge in das Dokument zusammen bringen, dann das halbfertige Werk kompilieren, und zwar das gesamte Dokument!, und mit einem geeigneten Treiber (DVI oder PDF) zu einer sichtbaren Form auf dem Bildschirm bringen und hoffen, daß es paßt.

Aus Erfahrung kann ich sagen, dass es mehrere Anläufe braucht, bis das Resultat deine Erwartungen entspricht.

Ich habe mich vor vielen Jahren mit TeX/LaTeX beschäftigt und kleine Anleitungen geschrieben; für mich hat es damals gereicht, aber was ich erlernt hatte war nur ein Bruchteil von dem, was TeX/LaTeX kann.

Also: es ist nicht selbsterklärend und für unversierte alles andere als geeignet.

MfG, Thiersee