Tagging Commits
Documentation menu
A release tag is the link between a package and the source that produced it. Tag the commit after the package is built and before the release is announced.
Naming
Use one tag format for every release and include the version. A tag that cannot be sorted or matched by a script is a tag that will be mistyped.
Automation
Create the tag in the pipeline so it cannot drift from the built artifact. If the tag already exists, fail the release instead of moving it; a moved tag breaks every reference to the old commit.
Traceability
With a tag, a package version and a changelog entry, a support question can be traced back to a specific commit without guessing.