fjh: Dokumentation von Softwareprojekten

Beitrag lesen

Hallo Martin,

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.

Die Tools sind sekundär, wenn das inhaltliche Konzept zur Dokumentation stimmt.

Ein SGML/XML-basierter Standard zur technischen Dokumentation ist DocBook z.B. in Kombination mit einem XML-Editor

http://www.docbook.org/

Es gibt dazu Standard-XSLT-Stylesheets zur Umwandlung in verschiedene Formate wie HTML, PDF usw.

Gruß
Franz