Documenting Class Libraries

[Matthijs ter Woord]

Hi,

I want to document my class libraries' API's. They're all in C#. I could use
the inline documentation comments, but I feel, using inline documentation
comments makes the source code messy. Are there any opensource tools which
allow me to document my library without using the source code?
Greets,

Matthijs ter Woord

[Atul]

See NDoc on sourceforge

-Atul, Sky Software http://www.ssware.com
Shell MegaPack ActiveX & .Net
Drop In Windows Explorer like Shell Browsing GUI controls for your app.
"Matthijs ter Woord" <ma**************@gmail.com> wrote in message
news:O1*************@TK2MSFTNGP14.phx.gbl...

Hi,

I want to document my class libraries' API's. They're all in C#. I could
use
the inline documentation comments, but I feel, using inline documentation
comments makes the source code messy. Are there any opensource tools which
allow me to document my library without using the source code?
Greets,

Matthijs ter Woord

[Matthijs ter Woord]

NDoc uses the C# xml documentation files, So i still need to enter ugly
comments in my code.
Greets

"Atul" <atulatsswaredotcom> wrote in message
news:eO*************@TK2MSFTNGP10.phx.gbl...

See NDoc on sourceforge

-Atul, Sky Software http://www.ssware.com
Shell MegaPack ActiveX & .Net
Drop In Windows Explorer like Shell Browsing GUI controls for your app.
"Matthijs ter Woord" <ma**************@gmail.com> wrote in message
news:O1*************@TK2MSFTNGP14.phx.gbl...

Hi,

I want to document my class libraries' API's. They're all in C#. I could
use
the inline documentation comments, but I feel, using inline documentation comments makes the source code messy. Are there any opensource tools which allow me to document my library without using the source code?
Greets,

Matthijs ter Woord

[Nick Malik [Microsoft]]

Current best practices state that you should associate your code as closely
with the documentation as possible. This has been a best practice for
better part of a decade. There is even a branch of computer science called
Literate Programming where the code is extracted from the documentation, not
the other way around.

If you don't want to look at the documentation, you can always collapse it.
When you create a standard code block, Visual Studio gives one of those
little "-" controls in the left margin. If you hit it, the documentation
collapses.

--
--- Nick Malik [Microsoft]
MCSD, CFPS, Certified Scrummaster
http://blogs.msdn.com/nickmalik

Disclaimer: Opinions expressed in this forum are my own, and not
representative of my employer.
I do not answer questions on behalf of my employer. I'm just a
programmer helping programmers.
--
"Matthijs ter Woord" <ma**************@gmail.com> wrote in message
news:O1*************@TK2MSFTNGP14.phx.gbl...

Hi,

I want to document my class libraries' API's. They're all in C#. I could
use
the inline documentation comments, but I feel, using inline documentation
comments makes the source code messy. Are there any opensource tools which
allow me to document my library without using the source code?
Greets,

Matthijs ter Woord

[Frans Bouma [C# MVP]]

Matthijs ter Woord wrote:

NDoc uses the C# xml documentation files, So i still need to enter
ugly comments in my code.
So? They're not ugly. (IMHO).
If you get Ghostdoc as well, you can make this very easy, as ghostdoc
already gives you good comments to start with with a press of a
keycombination.

http://www.roland-weigelt.de/ghostdoc/

Also, with XML comments you can include external written comments.
Afterall it's for sourcecode documentation, and the best thing you can
have is to have a close connection between sourcecode and the actual
documentation. Don't confuse it with code 'design' documentation
though, this is pure for a reference manual!

In VS.NET, set the Xml comment backgrounds to grey. This will also
give a better visual appearance for the xml comments and mark starts of
your methods visually, which makes code easier to read.

FB


"Atul" <atulatsswaredotcom> wrote in message
news:eO*************@TK2MSFTNGP10.phx.gbl...

See NDoc on sourceforge

-Atul, Sky Software http://www.ssware.com
Shell MegaPack ActiveX & .Net
Drop In Windows Explorer like Shell Browsing GUI controls for your
app.
"Matthijs ter Woord" <ma**************@gmail.com> wrote in message
news:O1*************@TK2MSFTNGP14.phx.gbl...

Hi,

I want to document my class libraries' API's. They're all in C#.
I could use
the inline documentation comments, but I feel, using inline documentation comments makes the source code messy. Are there any opensource
tools which allow me to document my library without using the source code?

--
------------------------------------------------------------------------
Get LLBLGen Pro, productive O/R mapping for .NET: http://www.llblgen.com
My .NET blog: http://weblogs.asp.net/fbouma
Microsoft MVP (C#)
------------------------------------------------------------------------