В дополнение ко недавнему обновлению раздела "Инструменты СА". Установил и попробовал в работе Eclipse IDE с расширением OpenAPI (см. скриншот в следующем посте). Разобраться можно, работает нормально. Есть навороченные функции, предназначенные скорее для разработчиков, которые я не настроил, но и не сильно пытался.
Понравилось.
1. Отличный навигатор по документу (вкладка "OpenAPI" на фрейме слева). Позволяет просто и удобно ориентироваться в тексте документа, что особенно важно, если документ большой. Также через контекстное меню навигатора можно одним щелчком мыши создавать в документе новые разделы разного типа и глубины вложенности с готовой структурой.
2. Если api уже реализован (мой случай), можно вызывать его методы с нужными параметрами прямо из текста документа или из того же навигатора (см. вкладку "Try it" на фрейме внизу). Или открывать документ в браузере через меню OpenAPI и работать стандартном для Swagger-а режиме.
Не понравилось.
1. Eclipse показался более тяжёлым, чем Visual Studio Code (дольше грузится, сложнее настраивается).
2. Просмотр/тестирование результирующего документа в той же среде, где находится редактор, мне показался более удобным, чем вариант с загрузкой в браузер.
Вывод.
Природный консерватизм не победить :). Остаюсь верен варианту Visual Studio Code c плагином OpenAPI (Swagger) Editor. А вы какие инструменты предпочитаете для OpenAPI, если не секрет? И что в них любите/не любите?