vcs.ref.base.revision
The revision, literally revised version, The revision most often refers to a commit object in Git, or a revision number in SVN.
base refers to the starting point of a change. For example, main
would be the base reference of type branch if you've created a new
reference of type branch from it and created new commits. The
revision can be a full hash value (see
glossary),
of the recorded change to a ref within a repository pointing to a
commit commit object. It does
not necessarily have to be a hash; it can simply define a revision
number
which is an integer that is monotonically increasing. In cases where
it is identical to the ref.base.name, it SHOULD still be included.
It is up to the implementer to decide which value to set as the
revision based on the VCS system and situational context.
Examples
- 9d59409acf479dfa0df1aa568182e43e43df8bbe28d60fcf2bc52e30068802cc
- main
- 123
- HEAD
Used by
metrics (2)
- vcs.change.time_to_approval (opt-in)
- vcs.change.time_to_merge (opt-in)
* required on that signal.
History
- v1.43.0stability
Promoted to release_candidate.
Already present at v1.30.0, the oldest release tracked here (development).