Пишу эту статью, потому что уже который раз сталкиваюсь с этой проблемой. И каждый раз трачу несколько часов, чтобы вспомнить, что проблемы нет. Каждый раз мне кажется, что Swagger UI не отображает описание из атрибута description аннотации @Schema из пакета io.swagger.v3.oas.annotations.media.
Читать далее @Schema description в Swagger UI