Skip to main content
Version: v2.18.x

Understanding Zowe release versions

Last updated
:  |
... min read
|
Edit this page
Print
Open doc issue

Understanding Zowe release versions

Zowe releases​

Zowe uses semantic versioning for its releases, also known as SemVer. Each release has a unique ID made up of three numbers that are separated by periods.

<Major Version>.<Minor Version>.<Patch Version>

Each time a new release is created, the release ID is incremented. Each number represents the content change since the previous release. For example:

  • 2.5.0 represents the fifth minor release since the first major release.
  • 2.5.1 represents the first patch to the 2.5.0 release.
  • 2.6.0 is the first minor release to be created after 2.5.1.

Major release​

A major release is required if changes are made to the public API and the code is no longer compatible with an earlier version.

When Zowe is version one, it is associated with the Zowe v1 conformance program. Offerings that extend Zowe and achieve the Zowe v1 conformance badge will remain compatible with Zowe throughout its version 1 lifetime. A major release increment because of incompatibility is sometimes referred to as a "breaking" change.

The first SMP/E build for Zowe v2 has a Functional Module ID (FMID) of AZWE002, which was created with content from the 2.0.0 release. Each major release will be its own SMP/E FMID where the last digit is updated, for example AZWE00V where V represents the major version.

Subsequent minor and patch releases to V2 are delivered as SMP/E PTF SYSMODs. Because of the size of the content, two co-requisite PTFs are created for each Zowe release.

While Major releases are required for a "breaking" change, they also can be used to indicate to the community a significant content update over and above what would be included in a minor release.

Minor release​

A minor release indicates that new functionality is added but the code is compatible with an earlier version. The Zowe community works on two-week sprints and creates a minor release at the end of these, typically once per month although the frequency might vary.

Patch​

A patch is usually reserved for a bug fix to a minor release.

On this page