21

I have always made a point of writing nice code comments for classes and methods with the C# xml syntax. I always expected to easily be able to export them later on.

Today I actually have to do so, but am having trouble finding out how. Is there something I'm missing? I want to go Menu->Build->Build Code Documentation, but there is no option to do that, there.

1

7 Answers 7

30

Actually it's in the project properties. Build tab, Output section, XML documentation file, and enter the filename. It will be built on every build of the project.

After that you can build the actual help with Sandcastle.

1
  • You can still write an XSL/XSLT to format the XML to a more nice result.
    – Biri
    Sep 20, 2008 at 9:48
4

You could try NDOC or SandCastle if you dont mind using 3rd party tools.

0
1

Sandcastle works pretty well for generating documentation and it supports a couple different formats for the generation. As far as I know, there isn't any Visual Studio integration for it, but there is a SandcastleGUI for it that is available.

1

Be careful if you're using LINQ to SQL as you won't be able to easily add sustainable comments to the auto-generated objects.

1

Late comment, but worth adding that even though Sandcastle is mothballed, the Sandcastle Help File Builder remains in active development, and I found it very powerful and straightforward to dive into when dealing with just this situation--install to rich .chm and .html/.asp output in a couple hours.

1

The previous answers are really out of date. Here are some more modern options:

  • DocFX: This is probably your best bet because it runs on Linux, macOS, and Windows and it's supported by the .NET Foundation.
  • Sandcastle Help File Builder (SHFB): This one is still supported but it might not be as active.
0

The original NDoc project (mentioned by others) is dead, but there is a new project called NDoc3.

NDoc3 supports .NET 2.0 - 3.5. It is currently available as a beta version and worked great for me. I'm not sure if the project is still active - the last beta was release in april 2009.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.