PC Review


Reply
Thread Tools Rate Thread

Commenting for document generator

 
 
Velvet
Guest
Posts: n/a
 
      4th Jan 2007
I have been developing ASP.NET applications. In 1.1 I added a <remark> tag
for each class and inside it I added my modification history (HTML
formatted). With the built-in function that allowed me to build web docs
from my comments, this would appear in the generated documentation. This
worked pretty well for the web docs.

VS 2005 no longer has a built-in doc generator so I'm not sure what to use
to build my docs now. I was told previously that NDoc would be the
generator that I want, but it is not and will not be available for 2.0.
(It's effectively dead). So what programs are people using for 2.0 now?

Also, I would like to know if people are adding a Modification History to
their class files and in what tag is it included so that it will be
available in the generated docs?

Thanks in advance,
Velvet


 
Reply With Quote
 
 
 
 
news.microsoft.com
Guest
Posts: n/a
 
      4th Jan 2007
The reason Ndoc is no longer actively being developed is that Microsoft has
been working on and recently released a project for generating MSDN style
documentation called "Sandcastle". You can download the CTP from December
at:

http://www.microsoft.com/downloads/d...displaylang=en

The CTP is difficult to use as it has no GUI, but there is a rather nice
implementation of a GUI for it located at:

http://codeplex.com/SHFB

 
Reply With Quote
Reply

Thread Tools
Rate This Thread
Rate This Thread:

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are Off


Similar Threads
Thread Thread Starter Forum Replies Last Post
C++\CLI: Supress XML Document Generator for unmanaged header files? Apoxy Microsoft VC .NET 9 24th Jul 2007 10:11 PM
Commenting for document generator Velvet Microsoft ASP .NET 2 9th Jan 2007 02:00 PM
Can the XML Document Generator ignore selected header files? Bruce Microsoft VC .NET 0 1st Jan 2007 02:14 AM
Help with Dynamic document generator =?Utf-8?B?TWljaGFlbA==?= Microsoft VB .NET 0 7th Apr 2005 03:01 PM
access document generator Nicko Microsoft Access Reports 0 1st Sep 2003 02:51 AM


Features
 

Advertising
 

Newsgroups
 


All times are GMT +1. The time now is 12:38 PM.