diff --git a/doc/enterprise/index.rst b/doc/enterprise/index.rst index 44d2f0d8cf..22461c29cb 100644 --- a/doc/enterprise/index.rst +++ b/doc/enterprise/index.rst @@ -64,7 +64,6 @@ Tarantool Enterprise Edition .. toctree:: :hidden: - changelog setup security audit diff --git a/doc/release/2.11.0.rst b/doc/release/2.11.0.rst index 5963006fc6..79aef8cd81 100644 --- a/doc/release/2.11.0.rst +++ b/doc/release/2.11.0.rst @@ -8,11 +8,11 @@ Releases on GitHub: :tarantool-release:`2.11.2`, :tarantool-release:`2.11.1`, :t The 2.11 release of Tarantool includes many new features and fixes. This document provides an overview of the most important features for the Enterprise and Community editions. -2.11 is the long-term support (LTS) release with four years of maintenance. -This means that you will continue to receive all the necessary security fixes and bug fixes throughout this period. +2.11 is the long-term support (LTS) release with two years of maintenance. +This means that you will receive all the necessary security fixes and bug fixes throughout this period, and +be able to get technical support afterward. You can learn more about the Tarantool release policy from the :doc:`corresponding document `. - .. container:: table .. list-table:: diff --git a/doc/release/3.0.0.rst b/doc/release/3.0.0.rst index b0115ee35a..0a346837dd 100644 --- a/doc/release/3.0.0.rst +++ b/doc/release/3.0.0.rst @@ -3,7 +3,7 @@ Tarantool 3.0 Release date: December 26, 2023 -Releases on GitHub: :tarantool-release:`3.0.0` +Releases on GitHub: :tarantool-release:`3.0.1`, :tarantool-release:`3.0.0` The 3.0 release of Tarantool introduces a new declarative approach for configuring a cluster, a new visual tool -- Tarantool Cluster Manager, diff --git a/doc/release/_images/releases_calendar.svg b/doc/release/_images/releases_calendar.svg index 6b5ffc4659..bfc5bd52d0 100644 --- a/doc/release/_images/releases_calendar.svg +++ b/doc/release/_images/releases_calendar.svg @@ -1,4 +1,4 @@ - + -
2.8
2.8
2.7
2.7
2.6
2.6
2.5
2.5
2.4
2.4
2.3
2.3
2.2
2.2
Series
Series
Q3
Q3
Q4
Q4
Q2
Q2
Q1
Q1
Jul
Jul
Aug
Aug
Sep
Sep
Oct
Oct
Nov
Nov
Dec
Dec
Apr
Apr
May
May
Jun
Jun
Jan
Jan
Feb
Feb
Mar
Mar
2021
2021
Q3
Q3
Q4
Q4
Q2
Q2
Q1
Q1
Jul
Jul
Aug
Aug
Sep
Sep
Oct
Oct
Nov
Nov
Dec
Dec
Apr
Apr
May
May
Jun
Jun
Jan
Jan
Feb
Feb
Mar
Mar
2022
2022
1.10.11
1.1...
1.10.10
1.1...
1.10.12
1.1...
2.6.3
2.6...
2.7.2
2.7...
2.7.3
2.7...
2.8.2
2.8...
2.8.3
2.8...
Release
Release
Support
Support
End of life (no more patches)
End of life (no more patches)
1.10.13
1.1...
2.7
2.7
1.10.14
1.1...
1.10.9
1.1...
2.6.2
2.6...
Q3
Q3
Q4
Q4
Q2
Q2
Q1
Q1
Jul
Jul
Aug
Aug
Sep
Sep
Oct
Oct
Nov
Nov
Dec
Dec
Apr
Apr
May
May
Jun
Jun
Jan
Jan
Feb
Feb
Mar
Mar
2023
2023
1.10.15
1.1...
2.10.1
2.1...
2.10.2
2.1...
2.10.3
2.1...
2.10.4
2.1...
2.10.0
2.1...
2.10.5
2.1...
2.10.6
2.1...
1.10 LTS
1.10 LTS
Series 2
Series 2
2.11 LTS
2.11 LTS
2.10
2.10
2.11.0
2.1...
2.8.4
2.8...
2.10.7
2.1...
2.11.1
2.1...
2.10.8
2.1...
Text is not SVG - cannot display
\ No newline at end of file +
2023
2024
2025
2026
Jan
Apr
Jul
Oct
Jan
Apr
Jul
Oct
Jan
Apr
Jul
Oct
Jan
3.0
3.0.0
3.0.1
2.11 LTS
2.11.0
2.11.1
2.11.2
2.10
2.10.5
2.10.6
2.10.7
2.10.8
2.8
2.8.4
Release
Updates and fixes
Support
x.y
EOL series
x.y
Current series
\ No newline at end of file diff --git a/doc/release/calendar.rst b/doc/release/calendar.rst deleted file mode 100644 index 21c4e1ece2..0000000000 --- a/doc/release/calendar.rst +++ /dev/null @@ -1,245 +0,0 @@ -Release calendar -================ - -Every Tarantool release series has :ref:`the same lifecycle `. -Below you can find the lifecycle of all Tarantool versions starting from 1.10.x, -as well as currently supported versions visualised as a calendar: - -.. ifconfig:: builder not in ('latex', ) - - .. image:: _images/releases_calendar.svg - :target: ../../_images/releases_calendar.svg - :align: left - :alt: releases_calendar.svg - -.. _release-table: - -Release lifetime table ----------------------- - -The release lifetime table lists all Tarantool versions -starting from 1.10.x up to the current latest versions. -Each link leads to the release notes page of the corresponding version. -*End of life* means the release series will no longer receive any patches, updates, -or feature improvements after the specified date. -*End of support* means that we won't provide technical support to product versions -after the specified date. - -.. container:: table - - .. list-table:: - - * - Version - - Release date - - End of life - - End of support - - * - :doc:`3.0.0 ` - - December 26, 2023 - - December 26, 2025 - - Not planned yet - - * - `2.11.2 LTS `_ - - December 7, 2023 - - May 24, 2025 - - Not planned yet - - * - `2.11.1 LTS `_ - - August 17, 2023 - - May 24, 2025 - - Not planned yet - - * - :doc:`2.11.0 LTS ` - - May 24, 2023 - - May 24, 2025 - - Not planned yet - - * - :doc:`2.10.8 ` - - September 14, 2023 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.7 ` - - May 24, 2023 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.6 ` - - March 22, 2023 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.5 ` - - February 20, 2023 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.4 ` - - November 11, 2022 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.3 ` - - September 30, 2022 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.2 ` - - September 1, 2022 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.1 ` - - August 8, 2022 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.10.0 ` - - May 22, 2022 - - September 14, 2023 - - Not planned yet - - * - :doc:`2.8.4 ` - - April 25, 2022 - - April 25, 2022 - - Not planned yet - - * - :doc:`2.8.3 ` - - December 22, 2021 - - April 25, 2022 - - Not planned yet - - * - :doc:`2.8.2 ` - - August 19, 2021 - - April 25, 2022 - - Not planned yet - - * - :doc:`2.7.3 ` - - August 19, 2021 - - August 19, 2021 - - August 19, 2021 - - * - :doc:`2.7.2 ` - - April 21, 2021 - - August 19, 2021 - - August 19, 2021 - - * - :doc:`2.6.3 ` - - April 21, 2021 - - April 21, 2021 - - April 21, 2021 - - * - :doc:`2.6.2 ` - - December 30, 2020 - - April 21, 2021 - - April 21, 2021 - - * - :doc:`2.5.3 ` - - December 30, 2020 - - December 30, 2020 - - December 30, 2020 - - * - :doc:`2.5.2 ` - - October 22, 2020 - - December 30, 2020 - - December 30, 2020 - - * - :doc:`2.4.3 ` - - October 22, 2020 - - October 22, 2020 - - October 22, 2020 - - * - :doc:`2.4.2 ` - - July 17, 2020 - - October 22, 2020 - - October 22, 2020 - - * - :doc:`2.3.3 ` - - July 17, 2020 - - July 17, 2020 - - July 17, 2020 - - * - :doc:`2.3.2 ` - - April 20, 2020 - - July 17, 2020 - - July 17, 2020 - - * - :doc:`2.2.3 ` - - April 20, 2020 - - April 20, 2020 - - April 20, 2020 - - * - :doc:`2.2.2 ` - - December 31, 2019 - - April 20, 2020 - - April 20, 2020 - - * - :doc:`1.10.15 LTS ` - - February 20, 2023 - - February 20, 2023 - - February, 2024 - - * - :doc:`1.10.14 LTS ` - - August 8, 2022 - - February 20, 2023 - - February, 2024 - - * - :doc:`1.10.13 LTS ` - - April 25, 2022 - - February 20, 2023 - - February, 2024 - - * - :doc:`1.10.12 LTS ` - - December 22, 2021 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.11 LTS ` - - August 19, 2021 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.10 LTS ` - - April 24, 2021 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.9 LTS ` - - December 30, 2020 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.8 LTS ` - - October 22, 2020 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.7 LTS ` - - July 17, 2020 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.6 LTS ` - - April 20, 2020 - - February 20, 2022 - - February 20, 2023 - - * - :doc:`1.10.5 LTS ` - - January 14, 2020 - - February 20, 2022 - - February 20, 2023 - - * - :ref:`1.10.4 LTS ` - - September 26, 2019 - - February 20, 2022 - - February 20, 2023 - - * - :ref:`1.10.3 LTS ` - - April 1, 2019 - - February 20, 2022 - - February 20, 2023 - - * - :ref:`1.10.2 LTS ` - - October 13, 2018 - - February 20, 2022 - - February 20, 2023 diff --git a/doc/enterprise/changelog.rst b/doc/release/enterprise-changelog.rst similarity index 98% rename from doc/enterprise/changelog.rst rename to doc/release/enterprise-changelog.rst index cc6092d554..03563636d3 100644 --- a/doc/enterprise/changelog.rst +++ b/doc/release/enterprise-changelog.rst @@ -1,12 +1,12 @@ -.. _enterprise_changelog: +.. _release-enterprise-changelog: -Changelog -========= +Enterprise SDK changelog +======================== Versioning policy ----------------- -A Tarantool Enterprise SDK version consists of two parts: +A :ref:`Tarantool Enterprise SDK ` version consists of two parts: .. code-block:: text @@ -523,4 +523,4 @@ r455 ---- - Added :ref:`binary protocol encryption `. -- Added :doc:`tuple field compression `. \ No newline at end of file +- Added :ref:`tuple field compression `. \ No newline at end of file diff --git a/doc/release/eol_versions.rst b/doc/release/eol_versions.rst index 63b3c1bb43..6ebee38b3b 100644 --- a/doc/release/eol_versions.rst +++ b/doc/release/eol_versions.rst @@ -1,14 +1,225 @@ +.. _release-eol-versions: EOL versions ============ -This page lists release notes for Tarantool versions that have reached -their end of life in accordance with the :doc:`release policy `. -See the :doc:`release calendar ` for more information. +This section contains information about Tarantool versions that have reached +their *end of life* in accordance with the :ref:`release-policy`. This +means that these versions don't receive updates and fixes anymore. However, we still +provide technical support for certain time after a version's EOL. The current support +status is reflected by the **End of support** column of the table below. + +For information about major changes between EOL versions, see :ref:`release-eol-major-features`. + +.. note:: + + Before 2.10.0, version numbers were subject to the :doc:`legacy versioning policy `. + +.. container:: table + + .. list-table:: + :header-rows: 1 + + * - Version + - Release date + - End of life + - End of support + + * - :doc:`2.10.8 ` + - September 14, 2023 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.7 ` + - May 24, 2023 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.6 ` + - March 22, 2023 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.5 ` + - February 20, 2023 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.4 ` + - November 11, 2022 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.3 ` + - September 30, 2022 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.2 ` + - September 1, 2022 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.1 ` + - August 8, 2022 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.10.0 ` + - May 22, 2022 + - September 14, 2023 + - Not planned yet + + * - :doc:`2.8.4 ` + - April 25, 2022 + - April 25, 2022 + - December 31, 2024 + + * - :doc:`2.8.3 ` + - December 22, 2021 + - April 25, 2022 + - December 31, 2024 + + * - :doc:`2.8.2 ` + - August 19, 2021 + - April 25, 2022 + - December 31, 2024 + + * - :doc:`2.7.3 ` + - August 19, 2021 + - August 19, 2021 + - August 19, 2021 + + * - :doc:`2.7.2 ` + - April 21, 2021 + - August 19, 2021 + - August 19, 2021 + + * - :doc:`2.6.3 ` + - April 21, 2021 + - April 21, 2021 + - April 21, 2021 + + * - :doc:`2.6.2 ` + - December 30, 2020 + - April 21, 2021 + - April 21, 2021 + + * - :doc:`2.5.3 ` + - December 30, 2020 + - December 30, 2020 + - December 30, 2020 + + * - :doc:`2.5.2 ` + - October 22, 2020 + - December 30, 2020 + - December 30, 2020 + + * - :doc:`2.4.3 ` + - October 22, 2020 + - October 22, 2020 + - October 22, 2020 + + * - :doc:`2.4.2 ` + - July 17, 2020 + - October 22, 2020 + - October 22, 2020 + + * - :doc:`2.3.3 ` + - July 17, 2020 + - July 17, 2020 + - July 17, 2020 + + * - :doc:`2.3.2 ` + - April 20, 2020 + - July 17, 2020 + - July 17, 2020 + + * - :doc:`2.2.3 ` + - April 20, 2020 + - April 20, 2020 + - April 20, 2020 + + * - :doc:`2.2.2 ` + - December 31, 2019 + - April 20, 2020 + - April 20, 2020 + + * - :doc:`1.10.15 LTS ` + - February 20, 2023 + - February 20, 2023 + - February, 2024 + + * - :doc:`1.10.14 LTS ` + - August 8, 2022 + - February 20, 2023 + - February, 2024 + + * - :doc:`1.10.13 LTS ` + - April 25, 2022 + - February 20, 2023 + - February, 2024 + + * - :doc:`1.10.12 LTS ` + - December 22, 2021 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.11 LTS ` + - August 19, 2021 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.10 LTS ` + - April 24, 2021 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.9 LTS ` + - December 30, 2020 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.8 LTS ` + - October 22, 2020 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.7 LTS ` + - July 17, 2020 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.6 LTS ` + - April 20, 2020 + - February 20, 2022 + - February 20, 2023 + + * - :doc:`1.10.5 LTS ` + - January 14, 2020 + - February 20, 2022 + - February 20, 2023 + + * - :ref:`1.10.4 LTS ` + - September 26, 2019 + - February 20, 2022 + - February 20, 2023 + + * - :ref:`1.10.3 LTS ` + - April 1, 2019 + - February 20, 2022 + - February 20, 2023 + + * - :ref:`1.10.2 LTS ` + - October 13, 2018 + - February 20, 2022 + - February 20, 2023 .. toctree:: - :maxdepth: 1 + :hidden: + major-features + legacy-policy 2.10.8 2.10.7 2.10.6 diff --git a/doc/release/index.rst b/doc/release/index.rst index 14041a94e5..8ff3aec7ff 100644 --- a/doc/release/index.rst +++ b/doc/release/index.rst @@ -6,20 +6,97 @@ Releases ======== -This section contains release notes for all Tarantool versions, starting from 1.6 up to the latest. +This section contains information about Tarantool releases: release notes, lifecycle +information, release policy, and other documents. To download Tarantool releases, check the `Download `_ page. -Since version 2.10, a :doc:`new release policy for Tarantool ` has been introduced. +All currently supported versions are listed on this page :ref:`below `. +The information about earlier versions is provided in :ref:`release-eol-versions`. -Backwards compatibility is guaranteed between all versions in the same :term:`release series`. +The Enterprise Edition of Tarantool is distributed in the form of an SDK that has +its own versioning. See the :ref:`release-enterprise-changelog` to learn about +SDK version numbering and changes. + +The detailed information about Tarantool version numbering and release lifecycle +is available in :ref:`release-policy`. + +Backward compatibility is guaranteed between all versions in the same :term:`release series`. It is also appreciated but not guaranteed between different release series (major number changes). To learn more, read the :doc:`Compatibility guarantees ` article. -.. toctree:: - :maxdepth: 2 +.. _release-supported-versions: + +Supported versions +------------------ + +Every Tarantool release series has :ref:`the same lifecycle ` +defined by the release policy. The following diagram visualizes the lifecycle of currently +supported Tarantool versions: + +.. image:: _images/releases_calendar.svg + :align: center + :alt: Release calendar + +The table below provides information about supported versions with links to their +*What's new* pages in the documentation and detailed changelogs on GitHub. +For information about earlier versions, see :doc:`eol_versions`. + +.. note:: + + *End of life* (*EOL*) means the release series will no longer receive any patches, + updates, or feature improvements after the specified date. Versions that haven't + reached their end of life yet are shown in **bold**. + + *End of support* (*EOS*) means that we won't provide technical support to product + versions after the specified date. - calendar - major-features +.. container:: table + + .. list-table:: + :header-rows: 1 + + * - Series + - First release date + - End of life + - End of support + - Versions + + * - :doc:`3.0 ` + - **December 26, 2023** + - **December 26, 2025** + - **Not planned yet** + - | :tarantool-release:`3.0.1` + | :tarantool-release:`3.0.0` + + * - :doc:`2.11 LTS ` + - **May 24, 2023** + - **May 24, 2025** + - **Not planned yet** + - | :tarantool-release:`2.11.2` + | :tarantool-release:`2.11.1` + | :tarantool-release:`2.11.0` + + * - 2.10 + - May 22, 2022 + - September 14, 2023 + - Not planned yet + - | :doc:`2.10.8 ` + | :doc:`2.10.7 ` + | :doc:`2.10.6 ` + | :doc:`2.10.5 ` + | :doc:`2.10.4 ` + | :doc:`2.10.3 ` + | :doc:`2.10.2 ` + | :doc:`2.10.1 ` + | :doc:`2.10.0 ` + + * - 2.8 + - August 19, 2021 + - April 25, 2022 + - December 31, 2024 + - | :doc:`2.8.4 ` + | :doc:`2.8.3 ` + | :doc:`2.8.2 ` .. toctree:: :maxdepth: 1 @@ -27,9 +104,6 @@ To learn more, read the :doc:`Compatibility guarantees ` article. 3.0.0 2.11.0 eol_versions - -.. toctree:: - :maxdepth: 2 - - policy_index + enterprise-changelog + policy compatibility diff --git a/doc/release/legacy-policy.rst b/doc/release/legacy-policy.rst index dbb7078bb3..44e64cd6fd 100644 --- a/doc/release/legacy-policy.rst +++ b/doc/release/legacy-policy.rst @@ -1,6 +1,11 @@ Tarantool legacy release policy =============================== +.. important:: + + This page describes the release policy that was used for Tarantool versions **before 2.10.0**. + + For information about the current release policy, see :ref:`release-policy`. A Tarantool release is identified by three digits, for example, 2.6.2 or 1.10.9: diff --git a/doc/release/major-features.rst b/doc/release/major-features.rst index 3b51c0ac92..2762171abf 100644 --- a/doc/release/major-features.rst +++ b/doc/release/major-features.rst @@ -1,10 +1,19 @@ +.. _release-eol-major-features: + Major features ============== +.. important:: + + This page is no longer maintained. + + The table below lists major changes in Tarantool versions **up to 2.11.0**. + For overviews of changes in newer versions, see their *What's new* pages inside :ref:`release`. + Every released version of Tarantool brings some notable features and fixes, which are all listed in the :doc:`release notes `. -To keep track of the major features in each version of the Tarantool easier, you can use the table below. +To keep track of the major features in Tarantool versions, you can use the table below. Later versions inherit features from earlier ones in the same release series. Note that versions before 2.10.* are numbered according to the :doc:`legacy release policy `, diff --git a/doc/release/policy.rst b/doc/release/policy.rst index 13d7f868aa..fe5d451ca7 100644 --- a/doc/release/policy.rst +++ b/doc/release/policy.rst @@ -1,8 +1,8 @@ +.. _release-policy: + Tarantool release policy ======================== -.. _release-policy: - Summary ------- @@ -351,5 +351,4 @@ No new versions are released since then. .. note:: - See all currently supported Tarantool versions visualised as :doc:`a calendar ` - or as :ref:`a release lifetime table `. + See all currently supported Tarantool versions in :doc:`Releases `. diff --git a/doc/release/policy_index.rst b/doc/release/policy_index.rst deleted file mode 100644 index f504ecbff2..0000000000 --- a/doc/release/policy_index.rst +++ /dev/null @@ -1,28 +0,0 @@ -Release policies -================ - -Since version 2.10, there's a :doc:`new release policy for Tarantool `. -In short, Tarantool version numbers consist of three parts: - -.. code-block:: text - - MAJOR.MINOR.PATCH - -Any version without extra prefixes is a release version. -If you need a version for production use, pick the latest release. -For evaluation and development, you can use beta versions. -They are marked with ``-betaN`` suffixes. - -Before 2.10.0, version numbers were subject to the -:doc:`legacy versioning policy `: - -.. code-block:: text - - MAJOR_VERSION.RELEASE_SERIES.RELEASE - -.. toctree:: - :hidden: - :maxdepth: 2 - - policy - legacy-policy