Skip to content

Versions support policy

What is a version?

Ogma v ersions follow a variation of Semantic Versioning. As a reminder, versions numbers are formatted as [major].[minor].[patch] (e.g. 3.1.6).

For example, Ogma 4.3.5 is a patch version that is part of the Ogma 4.3 minor version, which is itself part of the Ogma 4 major version.

Guidelines

  • Patch versions do not introduce breaking API changes, or new features. They fix bugs and usability issues. They may introduce small improvements and new optional API options.
  • Minor versions do not introduce breaking API changes
  • The last minor version of a major version is supported for 6 months after the next major version is released.
  • Bugs are only fixed in the latest minor of a major version.

Definitions

  • Breaking API change: a change that affects the API and forces customers to rewrite Ogma API calls (e.g. change the name of a method, make a new parameter mandatory).
  • Supported version: a version of Ogma for which major and critical bugs will be fixed.

Release frequency

Major versions are released at most once per year.

Minor versions are released approximately four times a year for the current major version.

Patch versions are released approximately twice a month, or more frequently if required to fix critical bugs.

Implications

  • When parts of the API are deprecated, they are only removed in the next major version;
  • You can safely bump the patch or minor version without having to rewrite existing code;
  • When bumping the major version, you might need to rewrite some existing code;
  • When a major version comes out, you have 6 months to migrate from the previous major version before it becomes unsupported;
  • When a bug is found in a major version, you may have to update to the latest minor version of that major version to get a bug fix.
minorfirst releaselast patchlast patch datesupport-endEOL dateSupport statusstatus
5.0.x1/16/20245.0.21/31/20247/31/20247/1/2024Latestyes
4.6.x11/28/20234.6.612/10/20236/10/20246/1/2024Stableyes
4.5.x7/21/20234.5.611/14/20235/14/20245/1/2024Maintenanceyes
4.4.x2/7/20234.4.64/13/202310/13/202310/1/2023Maintenanceno
4.3.x9/1/20224.3.111/29/20237/29/20232/1/2023Maintenanceno
4.2.x7/1/20224.2.28/1/20222/1/20232/1/2023Availableno
4.1.x4/1/20224.1.57/1/20221/1/20231/1/2023Availableno
4.0.x10/1/20214.0.106/1/202212/1/202212/1/2022Availableno
3.4.x5/1/20213.4.810/1/20214/1/20234/1/2022EOLno
3.3.x1/1/20213.3.194/1/202210/1/20221/1/2022EOLno
3.2.x11/1/20203.2.312/1/20206/1/20216/1/2021EOLno
3.1.x9/1/20203.1.510/1/20204/1/20214/1/2021EOLno
3.0.x3/1/20203.0.114/1/202210/1/202210/1/2022EOLno