Make svcutil pick up documentation from C# files?

Question

Folks,

I\'m creating a new WCF Service and started with my Service interface. Looks something like:

   public interface ISomethingService
    {
              


        

Answer 1

svcutil.exe consumes the "mex" API, and only has access to a subset of the metadata. Comments aren't included (nor, IIRC, is [DescriptionAttribute] to any great extent).

You might have to rely on external documentation (i.e. a help page / dead tree). One other option (although it breaks a number of pure SOA rules) is to ship the entities / interfaces in a dll + xml; svcutil (and the IDE) can re-use matching types from existing assemblies.

Answer 2

Maybe this helps: http://msdn.microsoft.com/en-us/library/aa717040.aspx

It works with svcutil as well.