Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How do I make xml documentation in Visual Studio 2012

How can I generate documentation of my C# web application in Visual Studio 2012, like Eclipse does?

like image 937
soamazing Avatar asked Dec 13 '12 12:12

soamazing


People also ask

How do I create an XML document in Visual Studio?

From the menu bar, choose Tools > Options to open the Options dialog box. Then, navigate to Text Editor > C# (or Visual Basic) > Advanced. In the Editor Help section, look for the Generate XML documentation comments option.

What is XML documentation in C#?

XML Documentation helps other programmers or developers to use your code (classes, functions and their members) easily by providing some useful information. XML Documentation starts with three slashes before the class or function to be documented.

What symbols are needed for an XML comment in Visual Studio?

The syntax for adding XML comments in your code is triple slashes /// followed by one of the supported XML tags.

How do you comment in XML?

Any text between <! -- and --> characters is considered as a comment.


2 Answers

In Visual Studio go to tools menu -> extension manager... then in extension manager click on online gallery (on the left), then type in the top right search box the text... ghostdoc It's a very nice document helper.

like image 162
Paul Zahra Avatar answered Oct 07 '22 20:10

Paul Zahra


You can comment your code using xml comments

/// <summary>
///  This class performs an important function.
/// </summary>

and then generate xml documentation after compiling the /doc. Here is the source: http://msdn.microsoft.com/en-us/library/b2s063f7.aspx

also I advixe you to use Sandcastle with its Help File Builder which is a very powerful tool: http://shfb.codeplex.com/

like image 33
Alex Avatar answered Oct 07 '22 18:10

Alex