Deliverables: as downloadable package or linked to a specific commit?

[AsamDiegoSanchez]

Is your feature request related to a problem? Please describe.

Right now we have the deliverable as links to the OpenMATERIAL 3D repository.

Describe the solution you'd like

I want to explore the following 2 options:

a) that we offer a downloadable package (similar to OpenDRIVE)

b) that we keep using links, but should point to a specific commit or tag (like the official release)

What do you think?

[LudwigFriedmann]

I'd suggest to create a release package.

[ClemensLinnhoff]

I would not put a download package in the documentation. In my opinion this is only used in OpenDRIVE, because it is not an open-source development. All our sources here are freely available.

So I would stick to links. You are right, we can put the release tag of the version in the link. But this can only be done very shortly before the actual release. Otherwise the links will be broken for a longer time. It is kind of a hen and egg problem. The links need to be correct in the release, but they can only be correct, after the release tag has been set.

[LudwigFriedmann]

But wouldn't it make the most sense to create a tag on the day of the TSC and create a release package 1.0 from it, which is then linked to from the documentation?

[ClemensLinnhoff]

But wouldn't it make the most sense to create a tag on the day of the TSC and create a release package 1.0 from it, which is then linked to from the documentation?

Yes, but you need to create the links first, then create the tag. Otherwise the correct links are not part of the tagged commit.

[LudwigFriedmann]

Yes, of course, the links would be invalid until the release is published. I'd therefore integrate them into the documentation shortly before the release and then create the tag and the release package from that tag.

The link can be specified as soon as we now how we want to name our release tag, see the link to the most recent esmini release : https://github.com/esmini/esmini/releases/tag/v2.45.1