C#, webAPI, контроллер, swagger: каким аттрибутом задаётся комментарий?

Question

жил я себе не тужил, расширял контроллеры своими методами, и писал атрибуты в стиле

    [HtpPost("А этот метод выдаёт отчет номер два!")]
    public async Task<List<string>> GetReport2(){ ... }

и очень радовался, что надпись А этот метод выдаёт отчет номер два! хорошо видна в swagger- интерфейсе.

И тут оказалось, что вообще то это - имя темплейта, и вообще так писать нельзя.

Что же делать? Видимо, есть какой то волшебный атрибут, чтобы написать комментарий, и его было видно в сваггере.

Пока просмотрел штук пять "руководств" - нигде про комментарии при помощи атрибутов в контроллерах ни слова.

Может, кто то знает эту магию?

Спасибо!

Answer 1

А ларчик просто открывался.

Вот так вот правильно:

    /// <summary> А этот метод выдаёт отчет номер два! <summary>
    [HtpPost("[action]")]
    public async Task<List<string>> GetReport2(){ ... }