Add 'Latest' Label to Current Release

[JacobCarrell]

Is your feature request related to a problem? Please describe

I'm trying to keep the Portainer API up to date in Postman (other tools apply). However, there is no branch, nor tag, that provides a static URL to the latest release.

Describe the solution you'd like

Include an action in the release pipeline to move/create a "latest" tag.

Describe alternatives you've considered

Maybe a branch instead, but I think that's a code smell.

Additional context

No response

[jamescarppe]

I'm assuming you're referring to a tag on the API documentation, yes?

[JacobCarrell]

No, In addition to tagging the commit a build of portainer was built from with the version, also tag it with "latest" - like docker, but git labels.

[jamescarppe]

https://github.com/portainer/portainer/releases/latest should send you to the latest release (2.19.4 at the time of writing). Is this what you're after?

[JacobCarrell]

At time of writing (2023-12-07), what I'm suggesting is that:

https://github.com/portainer/portainer/blob/2.19.4/api/swagger.yaml
and
https://github.com/portainer/portainer/blob/latest/api/swagger.yaml

would both link to the same thing. And to further clarify:

https://github.com/portainer/portainer/blob/2.20.0/api/swagger.yaml (future release)
and
https://github.com/portainer/portainer/blob/latest/api/swagger.yaml

would also link to the same thing.

Phrased a final way: A static URL that always links to the source of the currently released version.

[jamescarppe]

Right, thanks for the detail. I'll have a chat to the team in charge of that system to see what they think.

[JacobCarrell]

Following up (a bit late, oops), how did the team respond? I don't see a 'latest' tag yet.