|
|
@@ -5,43 +5,49 @@ Support Period Policy
|
|
|
|
|
|
* [中文版](./SUPPORT_POLICY_CN.md)
|
|
|
|
|
|
-Each ESP-IDF major and minor release (V4.0, V4.1, etc) is supported for
|
|
|
-18 months after the initial stable release date.
|
|
|
+Each ESP-IDF major and minor release (V4.1, V4.2, etc) is supported for
|
|
|
+30 months after the initial stable release date.
|
|
|
|
|
|
Supported means that the ESP-IDF team will continue to apply bug fixes,
|
|
|
security fixes, etc to the release branch on GitHub, and periodically
|
|
|
make new bugfix releases as needed.
|
|
|
|
|
|
-Users are encouraged to upgrade to a newer ESP-IDF release before the
|
|
|
-support period finishes and the release becomes End of Life (EOL). It is
|
|
|
-our policy to not continue fixing bugs in End of Life releases.
|
|
|
+Support period is divided into "Service" and "Maintenance" period:
|
|
|
+
|
|
|
+| Period | Duration | Recommended for new projects? |
|
|
|
+| ------- | ------------ | ------------------------------------- |
|
|
|
+| Service | 12 months | Yes |
|
|
|
+| Maintenance | 18 months | No |
|
|
|
+
|
|
|
+During the Service period, bugfixes releases are more frequent. In some cases,
|
|
|
+support for new features may be added during the Service period (this is
|
|
|
+reserved for features which are needed to meet particular regulatory
|
|
|
+requirements or standards for new products, and which carry a very low risk of
|
|
|
+introducing regressions.)
|
|
|
+
|
|
|
+During the Maintenace period, the version is still supported but only bugfixes
|
|
|
+for high severity issues or security issues will be applied.
|
|
|
+
|
|
|
+Using an “In Service” version is recommended when starting a new project.
|
|
|
+
|
|
|
+Users are encouraged to upgrade all projects to a newer ESP-IDF release before
|
|
|
+the support period finishes and the release becomes End of Life (EOL). It is our
|
|
|
+policy to not continue fixing bugs in End of Life releases.
|
|
|
|
|
|
Pre-release versions (betas, previews, `-rc` and `-dev` versions, etc)
|
|
|
are not covered by any support period. Sometimes a particular feature is
|
|
|
-marked as \"Preview\" in a release, which means it is also not covered
|
|
|
+marked as "Preview" in a release, which means it is also not covered
|
|
|
by the support period.
|
|
|
|
|
|
The ESP-IDF Programming Guide has information about the
|
|
|
[different versions of ESP-IDF](https://docs.espressif.com/projects/esp-idf/en/latest/versions.html)
|
|
|
(major, minor, bugfix, etc).
|
|
|
|
|
|
-Long Term Support releases
|
|
|
---------------------------
|
|
|
-
|
|
|
-Some releases (starting with ESP-IDF V3.3) are designated Long Term
|
|
|
-Support (LTS). LTS releases are supported for 30 months (2.5 years)
|
|
|
-after the initial stable release date.
|
|
|
-
|
|
|
-A new LTS release will be made at least every 18 months. This means
|
|
|
-there will always be a period of at least 12 months to upgrade from the
|
|
|
-previous LTS release to the following LTS release.
|
|
|
-
|
|
|
Example
|
|
|
-------
|
|
|
|
|
|
-ESP-IDF V3.3 was released in September 2019 and is a Long Term Support
|
|
|
-(LTS) release, meaning it will be supported for 30 months until February
|
|
|
-2022.
|
|
|
+ESP-IDF V3.3 was released in September 2019. It will be supported for 30 months
|
|
|
+until February 2022.
|
|
|
|
|
|
- The first V3.3 release was `v3.3` in September 2019.
|
|
|
- The ESP-IDF team continues to backport bug fixes, security fixes,
|
|
|
@@ -55,14 +61,23 @@ ESP-IDF V3.3 was released in September 2019 and is a Long Term Support
|
|
|
Existing Releases
|
|
|
-----------------
|
|
|
|
|
|
-ESP-IDF release V3.3 and all newer releases will follow this support
|
|
|
-period policy. The support period for each release will be announced
|
|
|
-when the release is made.
|
|
|
+ESP-IDF release V4.1 and all newer releases will follow this support period
|
|
|
+policy. The support period for each release will be announced when the release
|
|
|
+is made.
|
|
|
+
|
|
|
+For releases made before the current support period policy was announced, the
|
|
|
+original support periods apply:
|
|
|
+
|
|
|
+* ESP-IDF V4.0.x will be supported until October 2021
|
|
|
+* ESP-IDF V3.3.x will be supported until February 2022
|
|
|
+* ESP-IDF V3.1.x and V3.2.x will both be supported until October 2020.
|
|
|
+* ESP-IDF versions before V3.1 are already End of Life.
|
|
|
|
|
|
-For releases made before the support period policy was announced,
|
|
|
-the following support periods apply:
|
|
|
+Policy History
|
|
|
+--------------
|
|
|
|
|
|
-- ESP-IDF V3.1.x and V3.2.x will both be supported until October 2020.
|
|
|
-- ESP-IDF V3.0.9 (planned for October 2019) will be the last V3.0
|
|
|
- bugfix release. ESP-IDF V3.0.x is End of Life from October 2019.
|
|
|
-- ESP-IDF versions before V3.0 are already End of Life.
|
|
|
+* September 2019. This policy split ESP-IDF releases into Standard and Long Term
|
|
|
+ Support.
|
|
|
+* July 2020. All releases from now will have the same support period, which is
|
|
|
+ equal to the previous Long Term Support period. Added “In Service” period,
|
|
|
+ during which versions will receive more updates.
|
Angus Gratton