From fc6d5ae8911fff28cd16af1fb8db5284772afc2b Mon Sep 17 00:00:00 2001 From: Hugo Locurcio Date: Mon, 22 Jun 2020 11:01:29 +0200 Subject: [PATCH] Add a page describing Godot's release policy (#3662) --- about/img/eol.png | Bin 0 -> 435 bytes about/img/partial.png | Bin 0 -> 435 bytes about/img/supported.png | Bin 0 -> 435 bytes about/img/unstable.png | Bin 0 -> 374 bytes about/index.rst | 1 + about/release_policy.rst | 84 +++++++++++++++++++++++++++++++++++++++ 6 files changed, 85 insertions(+) create mode 100644 about/img/eol.png create mode 100644 about/img/partial.png create mode 100644 about/img/supported.png create mode 100644 about/img/unstable.png create mode 100644 about/release_policy.rst diff --git a/about/img/eol.png b/about/img/eol.png new file mode 100644 index 0000000000000000000000000000000000000000..ad9cb36e39a904aa08477b363da7f7d73ac8a1a5 GIT binary patch literal 435 zcmeAS@N?(olHy`uVBq!ia0vp^AhrMpGmw;6C|3leSkfJR9T^xl_H+M9WCilq1^9%x zZZq}VYT~)Z&~clI$2N2C9p*mU&AhjndC!-(-(lvn-P~u3me*D@@0kq7+s%Bofkn2P z`s_6Gs%Nm@YU&A80McdZxmM40vx#>o0|U^6Z3Z4dai9%Aa)+@u(EKeXK=lkj?LfsK zEv6uHi;?#>kafOWjXbv+du{~_ZZq@PX6glWz+x2-pcbHMTTHz`=2-Xw4Q%PzX$hpP zN`m}?vz#R~{r2w)V_UsLD2`=G@78!9W~+URT?Lhxwg@yc9?)`#VqRpq-))ilTo+^A zviaOa^SGG~2^~JdAQ1C?HPDnSPZ!4!4q4lSp+biZL|6{;8XH@kk-1$}{J&duDSv6V z!v@><{?%+9Khw%PW_^`GYZGg$^y~J^YS2cL1F7^&f{kl&mI#5l0eyG7v+Hr2s(N}?$8m56Q|@F zq8Lt}l|OnKq-9nc15nwSa}q$ku3-#7l|UQLUz7$ij+~MMnhcapYXFIZ5y-R?r)0ov z>9gnMkDZYLnsW%`44?uaS7Fy0KA?J_X+Uw1;`1N_-)w&30i>)-g8YKBB*HYESMS=- z<|nix&S&w~eXfE^%<)!BSb7DvFf}u39f)#R#B90WZISw1V;9{r?)gRYxS0+K9X`S! zb#>1lpeb3NE{-7_vbG09g$^5tupHzyHnut=bGxeef4AyV{?cxT4c7PjE=n9J*=xJT z?W@)+{(0@Tad02PE8ZUj^ivBNBI zn^DkKV~7cXV5}W?XUov8DeRC07zMt1o;I!vq@;~U%e|V%TH)W+!B`F zeXj9Jf?Jt=tQIo~Y+-CZpyd#?h}m+#+amS3F2=fL^SO(-=P?};I(&rTOYEhOKvS|j zT^vI=WNi|xA&jf59F=#ba4!kxSX7DfHi66@|EX{X1+A@UOkId z%Oo}->PnBR@%QsK2H7Wjc4Rs^EX;W}^W*02XRMeSjmyuR$x2I}vCgE}(1(L3{QQNK z885Ah7-o7Z~zUkqaiHjbbNlQ5>x%aOS4^NM= zZu+^owHePI&TMadvPhEen~%bBW8dp@BTbU;o%wnB^fKw=MhE|1IcXcq!Ld^^gN=b{ zentm}-8Lzpt5r)}BT7;dOH!?pi&B9UgOP!efv$m>u7O2}p^25DnU%4rwtFVdQ&MBb@0L3_lMF0Q* literal 0 HcmV?d00001 diff --git a/about/index.rst b/about/index.rst index 355c022b6..4ebbb2f51 100644 --- a/about/index.rst +++ b/about/index.rst @@ -8,6 +8,7 @@ About introduction faq docs_changelog + release_policy .. history .. authors diff --git a/about/release_policy.rst b/about/release_policy.rst new file mode 100644 index 000000000..d30a86930 --- /dev/null +++ b/about/release_policy.rst @@ -0,0 +1,84 @@ +.. _doc_release_policy: + +Godot release policy +==================== + +Godot versioning +---------------- + +Godot uses ``major.minor.patch`` version numbering. However, it does not +strictly follow `Semantic Versioning `__. This means that +releases considered "semver-minor" by that standard (such as 3.1 -> 3.2) will +most likely introduce breaking changes. Still, there won't be as many breaking +changes as a "semver-major" version bump such as 3.2 -> 4.0. + +In the interest of stability and usability, patch releases may occasionally +introduce small breaking changes as well. When repackaging Godot projects (e.g. +in a Flatpak), make sure to always use the same patch version as the one used to +initially export the project. + +.. note:: + + The first release in a major/minor release series doesn't end with a + trailing zero. For example, the first release in the 3.2 series is ``3.2``, + not ``3.2.0``. + +Release support timeline +------------------------ + +Godot versions are supported for a certain amount of time. While these durations +are not set in stone, here's a table with the expected level of support +for each Godot version: + ++-------------+-------------------+--------------------------------------------------------------------------+ +| **Version** | **Release date** | **Support level** | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 4.0 | ~2021 (see below) | |unstable| *Current focus of development (unstable).* | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 3.2 | January 2020 | |supported| Backwards-compatible new features (backported from the | +| | | ``master`` branch) as well as bug, security, and platform support fixes. | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 3.1 | March 2019 | |partial| Only critical, security and platform support fixes. | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 3.0 | January 2018 | |partial| Only critical, security and platform support fixes. | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 2.1 | July 2016 | |partial| Only critical, security and platform support fixes. | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 2.0 | February 2016 | |eol| No longer supported. | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 1.1 | May 2015 | |eol| No longer supported. | ++-------------+-------------------+--------------------------------------------------------------------------+ +| Godot 1.0 | December 2014 | |eol| No longer supported. | ++-------------+-------------------+--------------------------------------------------------------------------+ + +.. |supported| image:: img/supported.png +.. |partial| image:: img/partial.png +.. |eol| image:: img/eol.png +.. |unstable| image:: img/unstable.png + +**Legend:** +|supported| Full support - +|partial| Partial support - +|eol| No support (end of life) - +|unstable| Development version + +Pre-release Godot versions aren't intended to be used in production and are +provided on a best-effort basis. + +When is the next release out? +----------------------------- + +While Godot contributors aren't working under any deadlines, there's usually a +major or minor Godot release made available every year. Following this trend, +this means Godot 4.0 will most likely be released in **2021**. + +Patch releases are made available more frequently, typically every 2-6 months +while a release is fully supported. Partially supported releases will only have +new patch releases once an important security or platform support fix has been +merged. + +.. seealso:: + + The `roadmap `__ repository + documents features that have been agreed upon and may be implemented in future + Godot releases.