Appearance
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.1.x | 27/6/2024 | 5.1.3 | 5/8/2024 | 5/2/2025 | 1/1/2025 | Latest | yes |
| 5.0.x | 16/1/2024 | 5.0.5 | 29/3/2024 | 29/9/2024 | 1/7/2024 | Stable | no |
| 4.6.x | 28/11/2023 | 4.6.6 | 10/12/2023 | 10/6/2025 | 1/6/2024 | Maintenance | yes |
| 4.5.x | 21/7/2023 | 4.5.6 | 14/11/2023 | 14/5/2024 | 1/5/2024 | Maintenance | no |
| 4.4.x | 7/2/2023 | 4.4.6 | 13/4/2023 | 13/10/2023 | 1/10/2023 | Maintenance | no |
| 4.3.x | 1/9/2022 | 4.3.11 | 29/1/2023 | 29/7/2023 | 1/2/2023 | Maintenance | no |
| 4.2.x | 1/7/2022 | 4.2.2 | 1/8/2022 | 1/2/2023 | 1/2/2023 | Available | no |
| 4.1.x | 1/4/2022 | 4.1.5 | 1/7/2022 | 1/1/2023 | 1/1/2023 | Available | no |
| 4.0.x | 1/10/2021 | 4.0.10 | 1/6/2022 | 1/12/2022 | 1/12/2022 | Available | no |
| 3.4.x | 1/5/2021 | 3.4.8 | 1/10/2021 | 1/4/2023 | 1/4/2022 | EOL | no |
| 3.3.x | 1/1/2021 | 3.3.19 | 1/4/2022 | 1/10/2022 | 1/1/2022 | EOL | no |
| 3.2.x | 1/11/2020 | 3.2.3 | 1/12/2020 | 1/6/2021 | 1/6/2021 | EOL | no |
| 3.1.x | 1/9/2020 | 3.1.5 | 1/10/2020 | 1/4/2021 | 1/4/2021 | EOL | no |
| 3.0.x | 1/3/2020 | 3.0.11 | 1/4/2022 | 1/10/2022 | 1/10/2022 | EOL | no |