Forum Discussion

andrewcw's avatar
andrewcw
Frequent Visitor
7 years ago

Lost Big Picture - C# generated XML doc file

I dont know what group this goes to !  Help please  -I use Swashbuckler & generate an XML Doc file. The Doc File seems to be used by Swagger DLLs to render. But the only examples I found for decorating the C# code are in the code comments for /// <summary> something </summary> , and XML nodes remarks, and param name. <remarks> seems to map to 'Implementation Notes'   Are there other elements I can decorate above my API function in C# that will map to what I am trying to do ??  What I searched for how to add example and body for put/post model & example and I ended up looking at YAML files. is it ?  Looking in all the wrong places for what is probably quite simple... 

  1. What community group matches ?
  2. What is the mapping between the XML elements that feed the documentation XML file and the Swagger UI ?

Thanks Much