Using WCF in .NET how can I make it auto generate SOAP docs like ASMX did?

Question

I'm currently writing a web service using WCF in VB.NET.

Previous web services I wrote used ASMX but I wanted to learn WCF and so far it's going well. I actually prefer the way WCF does things.

One thing I miss however is the way that ASMX used to generate example SOAP requests and responses. It was like getting documentation for free.

Is there anyway to auto generate SOAP documentation for WCF?

If not, is there any way to generate it in a .NET page using the WSDL?

Answer 1

I eventually found the answer. WCFExtras. The WCFExtras library allows you to document your API using XML comments and it reads those comments and inserts them into the WSDL as documentation comments. We then read this and generate HTML documentation using an application called TechWriter.