Welche Code Dokumentation ist denkbar bzw. sinnvoll?

05/02/2008 - 14:31 von Thomas Eisenmann | Report spam
Hallo alle miteinander,

ich bin dabei ein Projekt mit VB 2005 zu programmieren, bzw. bin ich noch in
der Planungsphase. So mache ich mir jetzt schon Gedanken über die
Dokumentation, bzw. Erlàuterung des Quellcodes. In der Dokumentation sollen
meinen Kollegen oder ich in der Zukunft nachschlagen können, wie der Code
funktioniert hat bzw. welchen Zweck die einzelnen "Bausteine" erfüllen.

Dazu arbeite ich mit XML-Kommentare ('''), welche konsequent jeden
Software-Baustein beschreiben und dem Programmierer im Objektbrowser
angezeigt werden. In meinen bisherigen Projekten habe ich es dabei belassen.

Meine Fragen:

[1] Reicht das? Oder sollte ich die Dokumentation in ein anderes
Dokumentationsformate umwandeln? Durch die vorhandene XML-Datei, welche die
Kommentare enthàlt, hàtte ich eine gute Ausgangsposition, aber

[2] welches Zielformat ist denkbar bzw. sinnvoll? (.doc, Online Hilfe, o.à.)

[3] Hat VS 2005 schon Standard-Routinen zur automatischen Weiterverarbeitung?

[4] Welche Freeware-Routinen sind hilfreich?

[5] Welcher Vorteil bietet sich durch die Umwandlung der XML-Kommentare in
andere Dokumentationsformate?

Ich danke euch im Voraus für euere Hinweise.

Grüße Thomas
 

Lesen sie die antworten

#1 Thomas Eisenmann
05/02/2008 - 15:08 | Warnen spam
Sorry for 2 Posts

Ähnliche fragen