Dokumentation erstellen mit NDoc
NDoc erstellt eine Dokumentation aus den XML Kommentaren im Quelltext.
Die offizielle Version, die hier heruntergeladen werden kann, unterstützt allerdings nicht die Version 2.0 des .NET Frameworks. Eine eigenes Projekt “NDoc05” bietet .NET 2.0 Unterstützung, es handelt sich dabei allerdings noch um eine Beta Version. Ist .NET 2.0 Unterstützung notwendig, sollte die Version von Jonas Lagerblad verwendet werden, da sie momentan die stabilste Version ist. Man sollte sie eigentlich hier herunterladen können, allerdings ist das Blog zur Zeit häufig offline oder ohne Inhalt. Alternativ kann man auch die folgende .zip-Datei herunterladen, die ebenfalls zu funktionieren scheint.
In Visual Studio muss so konfiguriert werden, dass die XML Dokumentations-Datei bei jedem Build-Vorgang erstellt wird. Nach der Installation von NDoc kann NDoc über NDocGui.exe aufgerufen werden. Man wählt die Assemblies aus, für die eine Dokumentation erstellt werden soll, triff einige Einstellungen wie z.B. den Namen und den Speicherort der zu erstellenden Dokumentaion und lässt die Dokumentation erstellen.
Tags:.NET, Dokumentation, NDoc, Visual Studio, XML

