Dokumentation

Bellm

Grünschnabel
Hallo

im Moment beschäftige ich mich Dokumentation von Source...
Bisher habe ich mich mit 2 Möglichkeiten Beschäftigt, einmal mithilfe von xml und einmal mit Document X.

Leider hat meiner Ansicht nach bisher alles vor und Nachteile...

Bei XML hab ich das Problem das meistens im XML Kommentar mehr drin steht als im Source Code. Daher wird das Programm als ganzes sehr unübersichtlich.
Daher meine erste Frage: Gibt es eine Mögolichkeit die XML Kommentare ein bzw auszublenden. also ich meine nicht über das + - Symbol am Rand sondern eher langfristig auszuschalten so dass die xml kommentare unsichtbar werden.

Ich habe bisher document x getestet, aber auch hier gibt es ein paar sachen die mir nicht so gut gefallen: es ist mal verdammt langsam.... und dann tauchen meine dokumentierten sachen im objektbrowser von vs nicht auf.
So nun noch meine zweite Frage: kennt ihr noch andere externe Dokumentationstools, id recht gut sind?

Schon mal vielen Dank für eure Hilfe
 
Hi

Hallo

im Moment beschäftige ich mich Dokumentation von Source...
Bisher habe ich mich mit 2 Möglichkeiten Beschäftigt, einmal mithilfe von xml und einmal mit Document X.

Leider hat meiner Ansicht nach bisher alles vor und Nachteile...

Bei XML hab ich das Problem das meistens im XML Kommentar mehr drin steht als im Source Code. Daher wird das Programm als ganzes sehr unübersichtlich.
Daher meine erste Frage: Gibt es eine Mögolichkeit die XML Kommentare ein bzw auszublenden. also ich meine nicht über das + - Symbol am Rand sondern eher langfristig auszuschalten so dass die xml kommentare unsichtbar werden.

Ich habe bisher document x getestet, aber auch hier gibt es ein paar sachen die mir nicht so gut gefallen: es ist mal verdammt langsam.... und dann tauchen meine dokumentierten sachen im objektbrowser von vs nicht auf.
Das könnte dir helfen, dieses Add-in bietet das gewünschte Feature ;)
So nun noch meine zweite Frage: kennt ihr noch andere externe Dokumentationstools, id recht gut sind?
SandCastle
Schon mal vielen Dank für eure Hilfe
keine Ursache
 
Zurück