Page 13 : 13
Object-oriented Programming in C#
Documentation of Object-oriented Programs
* Documentation of Object-oriented Programs
Program Documentation
Program Documentation - When and Where?
Documentation of C# Programs
A documentation example in C#
The XML Documentation Language for C#
Tool support: The C# Compiler
Tool support: Doxygen
Tool support: Other possibilities
Another documentation example in C#
Conclusion - Documentation of C# Programs
* Project Recommendations
Documentation Recommendations
Documentation Recommendations
Recommendations for program documentation in your project
Use of Doxygen
Document the client interfaces of
all types (all classes)
in your project
Deliver the documentation as an
electronic enclosure
Arrange that the documentation is linked to a
clean version
the actual source program
Linked to source program
: Expert > Source Browser: SOURCE_BROWSER.
Clean version
: Expert > Source Browser: STRIP_CODE_COMMENTS
The documentation should not be written as a last minute effort
It is useful for fellow programmers during the project
The generated type documentation is a much more attractive entry point to your code than the raw source files