Как стать автором
Обновить

Комментарии 6

Имхо, большого смысла прыгать со сваггера на это нет, но при старте проекта вполне можно рассмотреть как вариант. Понравилось, что можно сразу получить от него готовый fetch для js.

Я тоже так считаю. Пока нет смысла, но хорошо, что есть возможность быстро переключиться. Допустим, в OpenAPI появится что-то очень нужное, а сваггер не будет это поддерживать.

Но в какой-то момент основные разработчики Swashbuckle покинули проект и начались трудности: копился техдолг, и запоздалая поддержка .NET 8 привела к проблемам совместимости.

Действительно, такой период был. Но сейчас проект активно развивается, все новые фичи платформы поддерживаются, релизы выпускаются. Нет причин для беспокойства.

Scalar безусловно проект интересный, но стоит обратить внимание, что это коммерческая разработка, где Scalar .NET — не отдельный самостоятельный репозиторий, а интеграционный пакет. В связи с этим есть определённые риски, которые надо учитывать.

Нет причин для беспокойства.

Как верно замечено — такой период был и может повториться. Потому согласен, именно сейчас нет причин для беспокойства, но всегда хорошо иметь альтернативный вариант в загашнике, не правда ли?

В связи с этим есть определённые риски

Тоже согласен, риски всегда есть. Так что хорошо, когда есть из чего выбрать.

На самом деле я не призываю срочно переходить со Swagger UI на Scalar. Да и не срочно тоже. Это скорее обзор на вполне себе достойную рабочую альтернативу, которую хорошо иметь на примете.

Обзор отличный, мой коммент не критика, а уточнение. Я бы сделал больше акцент на OpenApi от Microsoft, на который стоит переходить, а UI вообще можно и оба сразу добавить :)

Да, я понял - и я со всем согласен, как я и написал выше.

а UI вообще можно и оба сразу добавить :)

Про это кстати тоже думал и ради эксперимента добавлял. Это может быть полезно при переходе с одного на другое на "боевом" проекте, чтобы кто-то для уже начинал осваивать новый интерфейс, но при этом оставалась возможность работать с привычным

Спасибо за интерес к теме!

Зарегистрируйтесь на Хабре, чтобы оставить комментарий

Публикации