How do you specify controller descriptions?

I have a .NET Core web API written in C# and I have been unable to get NSwag to include descriptions for the controllers. I have tried a DescriptionAttribute and a standard <summary> comment. My actions and parameters are being properly documented, including description (summary) and remarks.

Also, I see from the documentation that there’s a recommendation to set IsAspNetCore to true. Where/how do you set that value and is it a current requirement? I’m not sure what the implications are of the “reflection based generator eventually being deprecated” - does that mean that I need to change my approach to controller documentation somehow?

[RicoSuter]

But what I’m lacking are descriptions on the actual controllers themselves.

The controller descriptions cannot be preserved because “controllers” is not a concept of Swagger and only internally generated/grouped by NSwag… We’d need to enhance the spec with custom data with controller info etc.

[drullo]

@RSuter , I do have xml doc output enabled in the project. Without it, I wasn’t getting any summary/parameter documentation at all. It is enabled and it is working for controller actions. But what I’m lacking are descriptions on the actual controllers themselves.

For clarification of what I’m looking for, the demo at http://petstore.swagger.io includes descriptions on each of the 3 controllers, as well as additional information displayed on the right.