# Versioning & Compatibility matrix

## Versioning

### YaK Core

YaK releases follow the Semantic Versioning scheme (SemVer), that encodes versions by a three-part version numbering (ex: YaK-A.B.C).

* The 1st digit (A) indicates the major version of the YaK Core
* The 2nd digit (B) indicates the minor version of the YaK Core
* The 3rd digit (C) is reserved for future use (ex: emergency fixes, patches... of the YaK Core)

### YaK Components

Each YaK Component follows the same versioning convention as the YaK Core (ex: Component-X.Y.Z)

* The 1st digit (X) is always in-line with the YaK Core major version (A)
* The 2nd digit (Y) indicates the major version of the YaK component itself (ex: Oracle-2.8.0)
* The 3rd digit (Z) is reserved for minor changes or patches/fixes of the component (Oracle PSU, HF, etc...)

## Compatibility matrix

Minor versions of the YaK Core/UI/CLI or of any YaK Component Types shall be cumulative. This means that any functionality or feature that worked in minor release "n" shall continue to work in the subsequent minor release "n+1".

However, this principle might not be always true for major releases as they might introduce breaking changes.

All components pertaining to the same major version should be compatible with the major core version. (ex: oracle-2.8.0 shall be compatible with all minor versions of the YaK Core 2.b.c).

## Support policy

Only the latest major version of the YaK Core is supported.

{% hint style="danger" %}
A preliminary upgrade to the latest YaK Core version is mandatory to receive support from dbi services.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dbi-services.gitbook.io/yak-user-doc/versioning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
