XML documentation comments

    I spent the morning hacking on XML documentation comments for the web service I have been working on for the last six months. The goal is to have user documentation for the API auto-magically generated from XML comments in the code. Remembering that this is all being done with Visual Studio 2003, I must say that I am finding the XML documentation comment support a little half baked. There's no support for C++. You can't get to the XML comments content via reflection. There doesn't seem to be a way to add a seealso to a different method in a class (just members as best as I can tell from the documentation).

    I'm told a bunch of this gets better in Whidbey. Here's hoping.

posted at: 18:32 | path: /dotnet | permanent link to this entry


    Add a comment to this post:

    Your name:

    Your email: Email me new comments on this post
      (Your email will not be published on this site, and will only be used to contact you directly with a reply to your comment if needed. Oh, and we'll use it to send you new comments on this post it you selected that checkbox.)


    Your website:

    Comments:


    Because of excessive load, this site is generated statically every several hours. Therefore, your comment may take some time to appear here. Unless you get an error message when you click the select button below, then all is normal and the comment will appear in due course.