.netsoapwsdl

How can I generate HTML documentation for a SOAP/WebService class in .Net?


When you start a WebService project in VisualStudio(VS) you do actually see some HTML documentation, but the C# comment help does not make it across to the HTML. You can get a description to come through for each web method by using the Description property of the WebMethod attribute, however this means duplicating text from the comment help and also doesn't allow for documenting web method arguments as far as I can tell.

Is there an easy way of picking up the comment help already present in C# code?

Thankyou.


Solution

  • We now use WCFExtra library to convert XML comments in my code into documentation comments in the WSDL.

    From there we use TechWriter to build the documentation.