Documentation of Objects

  • Thread starter Thread starter Mike Morse
  • Start date Start date
M

Mike Morse

Dies anyone know of a good way to document your classes.
I currently use the VB commenter for VS.net 2003 but that
does not provide any intellisence functionality for my
objects like description and such. Also when you select
tools > build comment web pages... I find these web pages
to be almost useless and less than satisfactory as
documentation.

I would really like to know how to document my objects
better.

Thanks All!

-mike
 
LOL.. to think, I was going to make the same suggestion...

Mike, unfortunatly, unless you use a VS.NET addin, you are not going to get
much use out of VB's meager commenting features. At least, not like you
would with C# and it's XML Documentation. I have seen one commenter that is
nice, but a bit pricey. CodeSmart for VS.NET (http://www.axtools.com/).

Anyhow,

HTH,

Bill Priess
 
Hello Mike,

XML comments is only supported in C# now. Please refer to
http://msdn.microsoft.com/msdnmag/issues/02/06/XMLC/default.aspx for details.

If you want to do it in other languages, I think you need to install some third party add-in or etc.

Thanks.

Best regards,
Yanhong Huang
Microsoft Online Partner Support

Get Secure! - www.microsoft.com/security
This posting is provided "AS IS" with no warranties, and confers no rights.

--------------------
!Content-Class: urn:content-classes:message
!From: "mike morse" <[email protected]>
!Sender: "mike morse" <[email protected]>
!References: <[email protected]> <[email protected]>
!Subject: Re: Documentation of Objects
!Date: Wed, 23 Jul 2003 12:50:49 -0700
!Lines: 38
!Message-ID: <[email protected]>
!MIME-Version: 1.0
!Content-Type: text/plain;
! charset="iso-8859-1"
!Content-Transfer-Encoding: 7bit
!X-Newsreader: Microsoft CDO for Windows 2000
!X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4910.0300
!Thread-Index: AcNRU7dB1HNJBzx5SaqeosxcsVGJ/Q==
!Newsgroups: microsoft.public.dotnet.framework.aspnet
!Path: cpmsftngxa06.phx.gbl
!Xref: cpmsftngxa06.phx.gbl microsoft.public.dotnet.framework.aspnet:161501
!NNTP-Posting-Host: TK2MSFTNGXA12 10.40.1.164
!X-Tomcat-NG: microsoft.public.dotnet.framework.aspnet
!
!Your f'n kiddig me. Yeah, why don't I just switch
!languages.
!
!>-----Original Message-----
!>Use C#, and Summary Tags.
!>
!>--
!>HTH,
!>
!>Kevin Spencer
!>Microsoft MVP
!>..Net Developer
!>http://www.takempis.com
!>Big things are made up of
!>lots of little things.
!>
!>!>> Dies anyone know of a good way to document your classes.
!>> I currently use the VB commenter for VS.net 2003 but
!that
!>> does not provide any intellisence functionality for my
!>> objects like description and such. Also when you select
!>> tools > build comment web pages... I find these web
!pages
!>> to be almost useless and less than satisfactory as
!>> documentation.
!>>
!>> I would really like to know how to document my objects
!>> better.
!>>
!>> Thanks All!
!>>
!>> -mike
!>
!>
!>.
!>
!
 
Back
Top