Dokumentation von Softwareprojekten

[Martin Friedrichs]

Hallo, Forumsteilnehmer.

Demnächst steht für ein von meiner Firma programmiertes Softwareprojekt eine Dokumentation an. Jetzt wollte ich fragen, wie "Profis" so etwas anfassen. Mir scheint es momentan so zu sein, dass jeder sein eigenes Süppchen braut und je nach Gusto Word, PDF-Writer, HTML etc. nutzt. Wir möchten im voraus eine zukunftsfähige Lösung nutzen, die Im Prinzip "ALLES" (also sowohl Produkte, als auch Vorgänge in unserer Firma etc.) dokumentieren kann.

Anforderungen sind:

1. Interne und Externe Dokumentation
Wir benötigen

• Benutzerhandbuch (Extern)
• Administrationshandbuch (Intern. enthält z.B. Coding-Rules, etc.)

2. Ursprungsformat kann umgewandelt werden in:
-XML
-HTML
-PDF
-CHM-Dateien
-?

3. Zukunftsfähigkeit
Wenn demnächst die neue Hype-Technologie nach XML erscheint, sollte ich es auch in dieses Format umwandeln können, ohne alles händisch umtragen zu müssen.

Also, wie machen das Profis? Welche Tools gibt es auf dem Markt? Was kosten diese?

Danke für Hilfe und Anregungen jeder Art!
Martin