Comments on: C# documentation comments: useless?

By: Documenter du code C# avec Doxygen « So@t blog

Documenter du code C# avec Doxygen « So@t blog — Fri, 02 Dec 2011 00:57:30 +0000

[...] Un retour d’expérience (toujours d’actualité même s’il date de plus de 3ans…) [...]

By: Rupert Barclay

Rupert Barclay — Mon, 25 Jul 2011 13:28:57 +0000

If you are willing to pay for a commercial tool you should take a look at Innovasys Document! X – we’ve been using it for some time and apparently it’s the tool also used by Infragistics and some other brand name .NET component ISVs to do their commercial docs which is a good sign. It’s an authoring tool as well as a documentation build tool – includes a Visual Comment Editor in VS as well as external authoring that our tech writers use. We also use it for database and XSD Schema docs (and I believe it does some other stuff too that we haven’t used).

By: Barry Jones

Barry Jones — Sun, 25 Jul 2010 15:59:05 +0000

You could also try Live Documenter.

By: Bennett

Bennett — Tue, 22 Sep 2009 08:20:57 +0000

@geac, thanks for the pointer. I hoped that Sandcastle would eventually become useful — great to see it’s being actively maintained.

By: geac

geac — Mon, 21 Sep 2009 14:03:53 +0000

I found the holy grail: Sandcastle Help File Builder.
http://shfb.codeplex.com/
This tool is outstanding.

By: Carlo

Carlo — Wed, 08 Jul 2009 14:25:15 +0000

Thanks a lot for the post. It save me so much time!!!
great work!!!

By: Matt

Matt — Thu, 19 Mar 2009 15:46:28 +0000

I think you’ve missed one of the best points of the Xml comments which is the tight integration with the IDE.

When you use a Class, Property or Method (from code) it will display the information contained within the Xml comment as a tooltip annotation to help you whilst you code. This is especially useful for method calls, as it will show you the comment for each parameter being passed to the method. This is cool because when a method has been commented correctly you know the purpose of each parameter as you type the code.

This also works when you distribute your code as a DLL, it will retain the comment documentation (unless you tell the compiler not to).

This all makes well doc-commented code super easy to use. The reason the compiler needs to know about the comments is so it can link them to their associated Class/Property/Method. This is not a bad thing, infact it’s super useful.

Matt

By: Andy Dent

Andy Dent — Thu, 05 Mar 2009 07:56:57 +0000

You don’t need to point Doxygen to graphviz provided graphviz binaries are on your path. Yes, it rocks!

By: Randy Fair

Randy Fair — Wed, 28 Jan 2009 01:51:34 +0000

Dude, you rock! Doxygen is major sweet and easy. It takes a little to get the graphs to work; make sure you install graphviz 1st and make sure you point the config file to its path location. Other than that, I dig it.

Thanks again!

By: Thiago

Thiago — Wed, 05 Nov 2008 00:36:35 +0000

Thank you! Best post of the internet!