Software Release Versioning
Software release versioning assigns stable identifiers to published software so people and tools can distinguish releases and reason about compatibility. A versioning policy explains what each identifier means and when it changes.
itDevOps and software delivery | OpenSkills.info
Course pathWalk it in order
Look it upDip in anytime
Go furtherLeaves this page
Don't Panic
Don't Panic - Software Release Versioning
Software Release Versioning is the subject of this course. A version is a stable name for a specific software release. The name helps people and tools answer three questions: which release is this, how does it relate to other releases, and what upgrade risk does the publisher claim?
The useful unit of work is a closed loop: clarify the goal and boundaries, gather the inputs the practice requires, make the decision or change, record evidence, and return with owners for the next cycle. Skipping any link leaves teams busy without durable results.
Tooling supports the loop; it does not replace it. Choose tools after the boundary and evidence model are clear. Comparing products without that model produces feature matrices that do not change how the work runs.
Common failure modes include undefined ownership, metrics that count activity instead of outcomes, and irreversible steps taken without a review path. Treat those as design defects in the practice, not as individual heroics to compensate later.
Operators should be able to explain which signals would change a decision this week. If no signal can change the plan, the practice has become ritual. Keep the feedback path short enough that evidence still influences the next cycle.
Name the owners for each stage of the loop before the work scales. Unowned stages become permanent exceptions. Record decisions with enough context that a future operator can tell why a tradeoff was accepted. Prefer fewer, sharper metrics that change behavior over broad dashboards that only describe activity after the fact.
Read the Intro for the core model. Use the Cheatsheet when you need the operating map. Updates tracks official guidance when this course configures an update source; otherwise the practice is settled without a live feed.
Where this skill leads
Relevant careers
See how this topic contributes to broader role-level skill maps.
Sources
- https://semver.org/
Supports
- Public API requirement and major, minor, patch change classification
- Normal version syntax, segment reset behavior, and initial development
- Pre-release syntax and precedence
- Build metadata syntax and exclusion from precedence
- Released package contents must not be modified
- https://packaging.python.org/en/latest/specifications/version-specifiers/
Supports
- Python version identifier segments, normalization, and ordering
- Dependency version specifiers as ecosystem-specific consumer constraints
- Distinction between public, pre, post, development, and local versions
- https://calver.org/overview.html
Supports
- Calendar Versioning as date-based release versioning
- Multiple documented calendar schemes and segment vocabulary
- Selection of a scheme to fit project needs
- https://git-scm.com/docs/git-tag
Supports
- Annotated tag data and optional signatures
- Annotated tags intended for releases and lightweight tags for temporary labels
- Risks of replacing a tag after consumers have fetched it
- https://www.conventionalcommits.org/en/v1.0.0/
Supports
- Structured commit message format
- Fix, feature, and breaking-change mappings to SemVer release types
- Other commit types have no implicit SemVer effect without a breaking marker
- https://keepachangelog.com/en/1.1.0/
Supports
- Changelog as a curated chronological list of notable changes
- Version entries, release dates, grouped change types, and Unreleased section
- Commit logs and consumer-facing changelogs serve different purposes
- https://semantic-release.gitbook.io/semantic-release
Supports
- Automated version determination, release-note generation, tagging, and publication
- Use of structured commit conventions in continuous integration
- Ordered release steps and requirements
- https://github.com/sindresorhus/awesome
Supports
- Discovery of the curated Continuous Integration and Continuous Delivery list
- https://github.com/cicdops/awesome-ciandcd
Supports
- Discovery of Jenkins, GoCD, and Open Build Service as release ecosystem tools
- https://www.jenkins.io/doc/book/pipeline/
Supports
- Jenkins Pipeline as a version-controlled model of build, test, and deployment stages
- Awesome Links rationale for Jenkins Pipeline
- https://docs.gocd.org/current/introduction/concepts_in_go.html
Supports
- GoCD pipelines, stages, jobs, materials, dependencies, and artifacts
- Awesome Links rationale for GoCD
- https://openbuildservice.org/help/manuals/obs-user-guide/art-obs-bg
Supports
- Open Build Service builds and distributes packages and images from source
- Multiple operating-system and architecture targets
- Awesome Links rationale for Open Build Service
