Tool zur Softwaredokumentation

[Woodstock]

Hallo!

Könnt Ihr mir ein Tool empfehlen, mit dem man Software dokumentieren und (Online-) Hilfen erzeugen kann?

Bine

[alexf10]

Meiner Meinung nach, ist Docbook für normale Dokumentation am besten geeignet.

[Woodstock]

Danke erstmal. Kannst Du mir sagen was das kostet? Gibt es davon eine Demo oder ne Trail? Und wo kann ich das bekommen - habe schon mal gesucht, aber ich finde immer wieder nur Sachen die man irgendwo einbinden soll.

Bine

[alexf10]

um Missverständnisse zu vermeiden: DocBook ist ein Tool mit dem es möglich ist aus "XML" Dateien in verschiedenen Formaten zu Produzieren (Latex, PDF,RTF, HTML, TXT und so weiter). Das Tool läuft sowohl unter Windows als auch unter Linux und ist kostenlos. Wenn du dich damit beschäftigen willst musst du viel lernen (über XML zum Beispie) was sich auf jeden Fall lohnt. Du kannst ziemlich scnell Doku in Unterschiedlichen Formaten erstellen und das auch noch Platformunabhängig. Ein Paar gute Seiten zum Thema:

http://www.docbook.org/

http://www.docbook.de/

http://www.stefan-rinke.de/articles/publish/

http://www.linuxsource.de/55

http://page.mi.fu-berlin.de/~cyganiak/xml/publishing/

http://www.kefk.net/Linux/Dokumentation/DTDs/DocBook/index.asp

http://www.inf.fu-berlin.de/inst/ag-nbi/lehre/0203/S_XMLT/ausarbeitungen/publishing.pdf

http://www.oreilly.de/catalog/docbook/chapter/book/docbook.html

http://trieloff.net/docbook/tutorial/docbook.pdf

gruß, Alex

[Woodstock]

Hmm, also ich suche eigentlich ein Tool was meine Quelltexte durchgeht, und anhand der Kommentare die Software dokumentiert (also im Grunde für die die nach mir an der Software eventuell programmieren). Ich glaube das ist das was Du meinst nicht - das ist eher für den Kunden gedacht - oder?

Bine

[alexf10]

stimmt :-/

ich habe aber auch ein Paar Programme gesehen die genau das machen was du dir vorstellst also Qielltext -> Doku die waren allerding für Linux. Es wäre auch wichtig zu wissen für welches Betriebsystem und Programmiersprache du das brauchst.

http://www.naturaldocs.org/

http://www.doc-o-matic.com/

http://www.xs4all.nl/~rfsber/Robo/index.html

http://www.stack.nl/~dimitri/doxygen/links.html

http://docpp.sourceforge.net/

http://aurigadoc.sourceforge.net/

gruß, alex

[Woodstock]

Hmm, also für mich persönlich Windows oder Linux und C++ bzw. PHP. Aber ich suche es für jemanden mit Windows (eventuell auch Linux) und Delphi!

Bine