Обновление до Swashbuckle.AspNetCore 3.0 больше не группирует по тегам

Question

Я использовал [SwaggerOperation(Tags = new[] { "GroupA" })] сгруппировать мои действия в контроллере в Swagger UI.

После обновления до 3.0 это больше не учитывается и группируется только по имени контроллера.

"Измененные" имена тегов из атрибута также больше не генерируются в Swagger JSON/YAML, в качестве тега используется только имя контроллера.

Мне не удалось найти подсказки в примечаниях к выпуску о критических изменениях этого поведения.

Буду очень признателен за любую информацию о поведенческих изменениях и / или о том, как я могу их восстановить

Answer 1

Так что все это хорошо документировано в примечаниях к выпуску, просто не стоит спешить, читая его.

Что я не упомянул в своем вопросе, так это то, что мне нужно было установить Swashbuckle.AspNetCore.Annotations получить [SwaggerOperation] назад (он был отделен).

И теперь они должны быть активно включены через:

services.AddSwaggerGen(c =>
{
   ...

   c.EnableAnnotations();
});

Из примечаний к выпуску:

Обновления аннотаций. Чтобы продолжить использовать аннотации, относящиеся к сваггеру, вам необходимо явно установить и включить новый пакет Swashbuckle.AspNetCore.Annotations, как описано здесь.

"здесь" приводит вас именно к тому месту, где описан этот шаг:

https://github.com/domaindrivendev/Swashbuckle.AspNetCore