mirror of
https://github.com/Sylius/Sylius.git
synced 2026-07-15 01:20:59 +00:00
bug #13903 [Documentation] Improve and fix the release cycle documentation (Zales0123)
This PR was merged into the 1.10 branch.
Discussion
----------
| Q | A
| --------------- | -----
| Branch? | 1.10
| Bug fix? | no
| New feature? | no
| BC breaks? | no
| Deprecations? | no
| Related tickets |
| License | MIT
I was quite surprised when I found out that our release cycle is called _time-based_ in our documentation 😱 That's definitely not the way we are releasing Sylius now (and it has not been for some past versions as well).
So, to improve transparency within the Community, I would like to document what are the factors we take into consideration when planning the new minor release and what are the consequences of this decision.
I've also remodelled the tables with past releases a little bit 💃
Do not fear, the 1.12 release date will be determined soon 🚀 🖖
Commits
-------
84acb22788 Explain in details how new Sylius release is planned
This commit is contained in:
Łukasz Chruściel
GitHub
commit
466cefb2fa
1 changed files with 63 additions and 39 deletions
|
|
@ -2,16 +2,32 @@ The Release Cycle
|
|||
=================
|
||||
|
||||
This document explains the **release cycle** of the Sylius project (i.e. the
|
||||
code & documentation hosted on the main ``Sylius/Sylius`` `Git repository`_).
|
||||
code & documentation hosted on the main ``Sylius/Sylius`` `repository`_).
|
||||
|
||||
Sylius manages its releases through a *time-based model* and follows the
|
||||
`Semantic Versioning`_ strategy:
|
||||
Sylius follows the `Semantic Versioning`_ strategy:
|
||||
|
||||
* A new Sylius minor version (e.g. 1.1, 1.2, etc.) comes out *at least every four months*.
|
||||
* A new Sylius patch version (e.g. 1.0.1, 1.0.2, etc.) comes out *at least every three weeks*.
|
||||
* A new Sylius patch version (e.g. 1.0.1, 1.0.2, etc.) comes out usually *once a month*, depending on the number of bug fixes developed
|
||||
* A new Sylius minor version (e.g. 1.1, 1.2, etc.) is released depending on various factors (see below), usually *once a few months*
|
||||
|
||||
New Sylius minor releases will drop unsupported PHP versions.
|
||||
|
||||
Scope-based vs time-based
|
||||
-------------------------
|
||||
|
||||
Sylius **release cycle** is **not** strictly time-based (contrary to the `Symfony release cycle`_). Based on the experience
|
||||
from over 10 minor versions, we decided that time is not the only reason on which we should rely when planning the new Sylius'
|
||||
version. Therefore, each new minor release of Sylius takes in consideration:
|
||||
|
||||
* what we would like to include in it (features, improvements, fixes)
|
||||
|
||||
* when we would like to release it (based on the Team capacity, estimated amount of work and experience from previous minor releases development)
|
||||
|
||||
.. note::
|
||||
|
||||
The natural consequence of such a decision is uncertainty regarding the exact time of the next minor version release.
|
||||
We try to estimate it as precisely as possible, but sometimes delays cannot be avoided. We believe that
|
||||
releasing a **good** product is more important than releasing it **fast** 🤖
|
||||
|
||||
Development
|
||||
-----------
|
||||
|
||||
|
|
@ -39,39 +55,8 @@ This maintenance is divided into:
|
|||
only security related issues can be fixed. The end of this period is referenced
|
||||
as being the *end of life* of a release.
|
||||
|
||||
Past Releases
|
||||
-------------
|
||||
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| Version | Release date | End of maintenance | End of life | Status |
|
||||
+=========+====================+====================+====================+=======================+
|
||||
| 1.0 | Sep 13, 2017 | May 13, 2018 | Jan 13, 2019 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.1 | Feb 12, 2018 | Oct 12, 2018 | Jun 12, 2019 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.2 | Jun 13, 2018 | Feb 13, 2019 | Oct 13, 2019 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.3 | Oct 1, 2018 | Jun 1, 2019 | Feb 1, 2020 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.4 | Feb 4, 2019 | Oct 4, 2019 | Jun 4, 2020 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.5 | May 10, 2019 | Jan 10, 2020 | Sep 10, 2020 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.6 | Aug 29, 2019 | Apr 29, 2020 | Dec 29, 2020 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.7 | Mar 2, 2020 | Nov 16, 2020 | Jul 16, 2021 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.8 | Sep 14, 2020 | May 14, 2021 | Jan 14, 2022 | Not supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.9 | Mar 1, 2021 | Nov 1, 2021 | Jul 1, 2022 | Security support only |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.10 | Jun 29, 2021 | May 14, 2022 | Jan 14, 2023 | Fully supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.11 | Feb 14, 2022 | Oct 13, 2022 | Jun 17, 2023 | Fully supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
|
||||
Future Releases
|
||||
---------------
|
||||
Future release
|
||||
--------------
|
||||
|
||||
+---------+----------------------+------------------------+--------------------+
|
||||
| Version | Development starts | Stabilization starts | Release date |
|
||||
|
|
@ -79,6 +64,44 @@ Future Releases
|
|||
| 1.12 | Feb 14, 2022 | To-be confirmed | To-be confirmed |
|
||||
+---------+----------------------+------------------------+--------------------+
|
||||
|
||||
Supported versions
|
||||
------------------
|
||||
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| Version | Release date | End of maintenance | End of life | Status |
|
||||
+=========+====================+====================+====================+=======================+
|
||||
| 1.11 | Feb 14, 2022 | Oct 13, 2022 | Jun 17, 2023 | Fully supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.10 | Jun 29, 2021 | May 14, 2022 | Jan 14, 2023 | Fully supported |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
| 1.9 | Mar 1, 2021 | Nov 1, 2021 | Jul 1, 2022 | Security support only |
|
||||
+---------+--------------------+--------------------+--------------------+-----------------------+
|
||||
|
||||
Unsupported versions
|
||||
--------------------
|
||||
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| Version | Release date | End of maintenance | End of life |
|
||||
+=========+====================+====================+====================+
|
||||
| 1.8 | Sep 14, 2020 | May 14, 2021 | Jan 14, 2022 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.7 | Mar 2, 2020 | Nov 16, 2020 | Jul 16, 2021 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.6 | Aug 29, 2019 | Apr 29, 2020 | Dec 29, 2020 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.5 | May 10, 2019 | Jan 10, 2020 | Sep 10, 2020 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.4 | Feb 4, 2019 | Oct 4, 2019 | Jun 4, 2020 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.3 | Oct 1, 2018 | Jun 1, 2019 | Feb 1, 2020 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.2 | Jun 13, 2018 | Feb 13, 2019 | Oct 13, 2019 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.1 | Feb 12, 2018 | Oct 12, 2018 | Jun 12, 2019 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
| 1.0 | Sep 13, 2017 | May 13, 2018 | Jan 13, 2019 |
|
||||
+---------+--------------------+--------------------+--------------------+
|
||||
|
||||
Backward Compatibility
|
||||
----------------------
|
||||
|
||||
|
|
@ -87,5 +110,6 @@ All Sylius releases have to comply with our :doc:`Backward Compatibility Promise
|
|||
Whenever keeping backward compatibility is not possible, the feature, the
|
||||
enhancement or the bug fix will be scheduled for the next major version.
|
||||
|
||||
.. _Git repository: https://github.com/Sylius/Sylius
|
||||
.. _repository: https://github.com/Sylius/Sylius
|
||||
.. _Semantic Versioning: http://semver.org/
|
||||
.. _Symfony release cycle: https://symfony.com/releases
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue