Scalar вместо Swagger UI. Надо ли оно нам?

[Vitimbo]

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

[m3ta10ph0b]

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

[pankraty]

Одна из фичей, которая есть в Scalar, но которую уже много лет не заводят в SwaggerUI - это возможность указать разные Client ID и scopes для разных способов авторизации. В SwaggerUI по какой-то причине эта настройка одна на все авторизационные flow. Собственно, в поисках способа обойти это ограничение я и пришел к Scalar.

[posledam]

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

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

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

[m3ta10ph0b]

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

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

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

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

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

[posledam]

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

[m3ta10ph0b]

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

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

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

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

[kemsky]

OpenAPI, который сделали MS - еще печальнее, чем NSwag и Swashbuckle, как и их генератор kiota. Дубовые, плохо кастомизируемые решения с очень неоднозначными "дезигн чойсами". Непонятно вообще, о каком они говорят развитии, если их решение отстает от всего, что уже есть. Scalar - все еще сырой, хотя сколько прошло времени.