Code Documentation for ASP.NET + VB.NET application

Question

We have a very old application dating back to ASP era which we are gradually refactoring to ASP.NET + VB.NET codebase.

It contains a lots of files with the below types:

aspx, asmx, ascx, vb, js (JavaScript), html, vbs (VBScript).

The backend database is SQL Server 2005 with lots of sprocs.

We would like to create a code documentation automatically generated from the comments in the code files. I liked Doxygen very much but seems like it does not support the above technologies. Can you please suggest some document generator tools, preferably a single tool or a group of tools?

Thanks a lot.

Ajit.

Thanks for taking time to respond. I myself use Sandcastle very much. SandCastle would not work for me since it is primarily API documentation tool, i.e. it takes assemblies (dlls) and generate the documents on various type members. I am more looking for extracting comments, file depency graph from from source code files belonging to the above listed technologies. I would like comparative tool like Doxygen for above technologies. Thanks again. — Ajit Singh
– Ajit Singh, Commented Jul 21, 2009 at 5:41

Kirtan · Accepted Answer · 2009-07-21 04:35:15Z

2

You can take a look at Microsoft's Sandcastle tool. I've used it many times, and it generates documentation based on the comments provided in your .NET code. If I remember correctly, it can also generate documentation for JavaScript libraries.

answered Jul 21, 2009 at 4:35

Kirtan

21.7k6 gold badges50 silver badges61 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

Jimmy Chandra · Accepted Answer · 2009-07-21 04:35:33Z

0

There are some out there:

SandCastle

NDOC

answered Jul 21, 2009 at 4:35

Jimmy Chandra

6,5904 gold badges29 silver badges38 bronze badges

2 Comments

Kirtan Over a year ago

@Ajit & @Jimmy: NDOC is a very very old tool (about 4 years). Its not under maintenance anymore. Its better if you don't use it.

Jimmy Chandra Over a year ago

Ah thanks :). I was just looking for a secondary option. In my previous company we tried SandCastle as well to do the doc.

Anirudh Goel · Accepted Answer · 2009-07-21 04:55:44Z

i've used SandCastle and it works too good if you have xml comments in your code.

You first enable xml documentation in your project by setting it in Project Properties -> Compile -> Generate XML Documentation.

Once done you may have to set treat warnings as errors, so that the studio can point out to you where and all the XML comments are missing.

To add an XML Comment, you place your cursor before a class definition or a function definition and type

///

This will automatically generate xml tags for documentation and then once you are done, you can import the project and start to build the documentation.

The good part is, if you have documented your classes well, when you use those functions in your application upon mouse over you can find the description which you wrote, much like how intellisense documentation works.

Let me know if you run into any other issues.

My last suggestion, make a hello world project and xml document it and get used to sandcastle with it.

Collectives™ on Stack Overflow

Code Documentation for ASP.NET + VB.NET application

3 Answers 3

Comments

2 Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

3 Answers 3

Comments

2 Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related