Swap swagger ui to scalar

[TheFox0x7]

Feature Description

When browsing api docs swagger doesn't provide any kind of search, overview or navigation through the docs, limiting discoverability of api routes.

I propose we swap to scalar instead which provides navigation and more interactive system to test out api.
See demo site, to setup a view of gitea api for more realistic demo:

1. click import url and paste https://demo.gitea.com/swagger.v1.json in there
2. Switch to preview tab at the top

I did try integrating it myself but that bloated the end binary with 1.2MB and I'm not knowledgeable enough in JS to say if this is expected or have I did it incorrectly as the line script version fetches ~800kB (compressed).

Screenshots

General view with search:

Request sending screen:

[TheFox0x7]

few comments about this:
This idea was in my mind since I took a look at huma before which linked to swagger, this and stoplight elements (the default there).
If I did it correctly and the bloat is expected this isn't as appealing but it might be worth considering - at a later date if anything.

[silverwind]

Personally I prefer swagger-ui because I'm used to it, but not blocking.

Also, fyi there once was an effort to render user documents with it too (#26802), like GitLab also does.

[TheFox0x7]

I don't mind it staying like it is currently because it does work as it should. The only thing I have against it is that looking for an endpoint that you don't know in which section it is (unless there's some magic trick I don't know of), it's annoying to find as the best strategy for this is to open all actions and ctrl+f it.

I thought it was better at payload description but it seems my memory failed me as I don't see it very different from swagger model view... maybe I merged that and stoplight version in my mind.

[silverwind]

Yeah lack of seach in swagger-ui is annoying. It seems there have been efforts, but as of today, it has no usable search feature. So I guess it is worth exploring alternatives.

[silverwind]

BTW scalar seems to perform quite well, as opposed to https://docs.gitea.com/api/1.24/ which lags my browser (no idea what is in use there currently).

[TheFox0x7]

redocusaurus. Out of curiosity I'll see if swapping it for scalar won't lag as much as I did see that too.

[lunny]

I think we can try scalar instead redocusaurus in docs repository first.