diff --git a/docs/reference/releases.md b/docs/reference/releases.md new file mode 100644 index 0000000..4315bf0 --- /dev/null +++ b/docs/reference/releases.md @@ -0,0 +1,16 @@ +# Release Naming + +CalVer-style is used starting with the release in December 2024. + +`YY.MINOR.PATCH` where: + +`YY`: short calendar year (24, 25, 26) +`MINOR`: zero-padded release number in the calendar year (01, 02, 03) - that's what we'll call an actual release +`PATCH`: patch number for a specific release (1, 2, 3) - just some bug fixes for a release + +First release of the 2025 is 25.01 and patch releases for it named 25.01.1, 25.01.2, etc (if needed). +Last release of the 2024 is 24.09, it was originally named B2 (Beta 2). + +API backward compatibility and in-place upgrades are guaranteed starting with B1 release. Some new features may require +manual intervention or installation from scratch to get them enabled, in this case, it will be explicitly mentioned in +the release notes.