Я смотрю на API с огромным количеством информации в общем поле «описание».Мы говорим о оглавлении и нескольких разделах.Действительно подробные и широкие документы.Внешний веб-сайт для документов в настоящее время не вариант, так что это имело смысл в то время, я думаю.
В Swagger UI это выглядит как много текста, прежде чем пользователь нажмет определения API.Слишком много прокрутки для хорошего пользовательского опыта.
Моя главная цель - улучшить пользовательский опыт, API работает нормально (просто тяжело копаться в документации для новых пользователей.)
Я надеюсь использовать https://github.com/jensoleg/swagger-ui для улучшения этого опыта.
Я думал, что у меня есть решение моей проблемы путем создания тега «документации» и разбиения документации на разделы, как при выполнении отдельных операций.В некоторой степени это работало, поле описания операции позволяло идеально отображать документацию, но это было сделано путем замены содержимого, найденного в реальной операции (очевидно, не окончательное решение)
Так есть ли фиктивный или неактивный тип операции, который позволил бы мне иметь группу документации, являющуюся частью расширяемого меню Swagger UI?Или есть лучший способ добиться этого?