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.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 |