Жил я себе не тужил, расширял контроллеры своими методами, и писал атрибуты в стиле
[HtpPost("А этот метод выдаёт отчет номер два!")]
public async Task<List<string>> GetReport2(){ ... }
и очень радовался, что надпись А этот метод выдаёт отчет номер два!
хорошо видна в swagger- интерфейсе.
И тут оказалось, что вообще-то это - имя темплейта, и вообще так писать нельзя.
Что же делать? Видимо, есть какой-то волшебный атрибут, чтобы написать комментарий, и его было видно в сваггере.
Пока просмотрел штук пять "руководств" - нигде про комментарии при помощи атрибутов в контроллерах ни слова.
Может, кто то знает эту магию?
Спасибо!
xml
коментов, которые в свою очередб генерятся на основеsummary
коментов. Чтобы сгенерироватьsummary
комментарий - достаточно в коде написать три слеша (VS) и сгенерится комментарий (например для функции), в котором будут отображены входящие и исходящие параметры автоматом...останется только написать что они значат. Поэтому читайте про summary и смотрите что туда можно записать...и свагер по нему сгенерит описание api