Microsoft Visual C# 2012 - Das Entwicklerbuch. Mit einem ausführlichen Teil zur Erstellung von Windows Store Apps

Kapitel 21. XML-basierte Dokumentierung

In diesem Kapitel:

• „Einführung“

• „XML-Dokumentationskommentare“

• „XML-Dokument erzeugen“

• „Lesbare Dokumentationsseiten“

Warum nur gibt es solche Unmengen an schlecht oder unvollständig dokumentiertem Code, wo sich doch eigentlich alle einige sind, wie wichtig und sinnvoll die Kommentierung und Dokumentierung ist? Ein Grund ist sicherlich, dass die meisten Software-Projekte unter enormem Zeitdruck entstehen, ein weiterer, dass das Gros der Programmierer die Kommentierung und Dokumentierung als eine eher lästige Aufgabe ansehen. Keine günstigen Voraussetzungen also.

Sprachen wie C#, oder auch Java, haben erkannt, dass sie sich hier nicht länger aus der Verantwortung stehlen können. Sie bieten spezielle Dokumentationskommentare ...