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.

minor	first release	last patch	last patch date	support-end	EOL date	Support status	status
5.0.x	1/16/2024	5.0.5	3/29/2024	9/29/2024	7/1/2024	Latest	yes
4.6.x	11/28/2023	4.6.6	12/10/2023	6/10/2024	6/1/2024	Stable	yes
4.5.x	7/21/2023	4.5.6	11/14/2023	5/14/2024	5/1/2024	Maintenance	yes
4.4.x	2/7/2023	4.4.6	4/13/2023	10/13/2023	10/1/2023	Maintenance	no
4.3.x	9/1/2022	4.3.11	1/29/2023	7/29/2023	2/1/2023	Maintenance	no
4.2.x	7/1/2022	4.2.2	8/1/2022	2/1/2023	2/1/2023	Available	no
4.1.x	4/1/2022	4.1.5	7/1/2022	1/1/2023	1/1/2023	Available	no
4.0.x	10/1/2021	4.0.10	6/1/2022	12/1/2022	12/1/2022	Available	no
3.4.x	5/1/2021	3.4.8	10/1/2021	4/1/2023	4/1/2022	EOL	no
3.3.x	1/1/2021	3.3.19	4/1/2022	10/1/2022	1/1/2022	EOL	no
3.2.x	11/1/2020	3.2.3	12/1/2020	6/1/2021	6/1/2021	EOL	no
3.1.x	9/1/2020	3.1.5	10/1/2020	4/1/2021	4/1/2021	EOL	no
3.0.x	3/1/2020	3.0.11	4/1/2022	10/1/2022	10/1/2022	EOL	no