-
Notifications
You must be signed in to change notification settings - Fork 8
Description
Consistent release version numbers and corresponding git tags are not only expected by users of our software, but also necessary for automated tools, such as dependency scanners, or downstream packager update detectors (see secure-systems-lab/securesystemslib#167 and in-toto/in-toto#286 for discussions).
Versioning
"semantic versioning" (semver) provides a clearly defined de-facto standard, which we already adhere to with TUF, in-toto and securesystemslib (more or less). We should make this a principle and be strict about it.
Tagging
The easiest way seems to just use the semantic version number as git tag name. However, @SantiagoTorres has a compelling argument for v
-prefixing the semantic version string, that is command line auto-completion (e.g. git checkout v[tab]
).
Most importantly, there should be no switching between conventions, such as a mix of X.Y.Z
, vX.Y.Z
or <arbitrary-prefix>vX.Y.Z
(see in-toto#releases and securesystemslib#releases).