Hi,
ich möchte ein Projekt nach der (fast) Fertigstellung nun ausreichend Dokumentieren.
Die XML Dokumentation von VS 05 gefällt mir so weit ganz gut, vor allem kann ich daraus eine schöne HTML Dokumentation mit dem Entsprechenden Tool machen.
Nur mein Problem: Ich möchte meine ganzen Klassen und Methoden nicht direkt im Quellcode dokumentieren, Beispiel:
Wenn ich nämlich alle Methoden ausreichend dokumentiere, werden die Dokumentationen länger als der eigentlich Code...
Gibt es da keine Möglichkeit externe "Dokumentationsdateien" zu machen? Ich habe im VS noch nichts passendes gefunden...
weiss da wer was?
ich möchte ein Projekt nach der (fast) Fertigstellung nun ausreichend Dokumentieren.
Die XML Dokumentation von VS 05 gefällt mir so weit ganz gut, vor allem kann ich daraus eine schöne HTML Dokumentation mit dem Entsprechenden Tool machen.
Nur mein Problem: Ich möchte meine ganzen Klassen und Methoden nicht direkt im Quellcode dokumentieren, Beispiel:
C#:
/// <summary>
/// Diese Methode gibt einen leeren String zurück :-P
/// </summary>
/// <param name="blub">der Parameter ist eigentlich umsonst</param>
/// <returns>Leerer String</returns>
string MeineMethode(string blub)
{
return "";
}
Wenn ich nämlich alle Methoden ausreichend dokumentiere, werden die Dokumentationen länger als der eigentlich Code...
Gibt es da keine Möglichkeit externe "Dokumentationsdateien" zu machen? Ich habe im VS noch nichts passendes gefunden...
weiss da wer was?