Show Gitea version in swagger

[techknowlogick]

Fix #14645

[jpraet]

Won't the API version need to evolve separately from the Gitea version?
Maybe in Gitea 1.15 there are no changes to the API, then why update its version?
Maybe in Gitea 2.x there are no major changes to the API and we want to keep the endpoint as /api/v1?

For obtaining the Gitea version through the API there is https://try.gitea.io/api/v1/version.

[6543]

well it's only to generate swagger docs ... at the moment it is useless and i think it's save to use gitea's version to version the swagger json with it ...

[6543]

@techknowlogick now it looks good, we just have to replace + with - since it is displayed as +

[jpraet]

If it's only for documentation purposes then I would suggest
"description": "This documentation describes the v1 API of Gitea {{AppVer}}." while still keeping the flexibility of being able to evolve the API version and Gitea version independently.

[6543]

we did not evolve API and Gitea independently (We do not backport api features)

[lafriks]

From security perspective it should be show only if allowed by setting to show version number

[techknowlogick]

@lafriks app version is visible many places elsewhere in app, such as the MD5 for cache busting of JS & CSS assets

[6543]

🚀

[jpraet]

The + is displayed as +

[lunny]

The + is displayed as +

Could you fire a new issue?