[dpdk-dev,v1] doc: add guidelines on stable and lts releases

Message ID 1484312782-21120-1-git-send-email-john.mcnamara@intel.com (mailing list archive)
State Accepted, archived
Delegated to: Thomas Monjalon
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel compilation success Compilation OK

Commit Message

John McNamara Jan. 13, 2017, 1:06 p.m. UTC
  Add document explaining the current Stable and LTS process.

Signed-off-by: John McNamara <john.mcnamara@intel.com>
---

V1: For background see previous discussions on Stable and LTS releses:

   http://dpdk.org/ml/archives/dev/2016-July/044848.html
   http://dpdk.org/ml/archives/dev/2016-June/040256.html

doc/guides/contributing/index.rst  |  1 +
 doc/guides/contributing/stable.rst | 99 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 100 insertions(+)
 create mode 100644 doc/guides/contributing/stable.rst
  

Comments

John McNamara Jan. 13, 2017, 1:14 p.m. UTC | #1
> -----Original Message-----
> From: Mcnamara, John
> Sent: Friday, January 13, 2017 1:06 PM
> To: dev@dpdk.org
> Cc: Liu, Yuanhan <yuanhan.liu@intel.com>; thomas.monjalon@6wind.com;
> Mcnamara, John <john.mcnamara@intel.com>
> Subject: [PATCH v1] doc: add guidelines on stable and lts releases
> 
> Add document explaining the current Stable and LTS process.

Hi,

Just a reminder that DPDK 16.07 was a stable release, 16.11 is a stable
release and it will also become the 2 year LTS release.

Some links:

    http://dpdk.org/ml/archives/stable/ - Mailing list
    http://dpdk.org/download - Download page for mainline and stable release
    http://fast.dpdk.org/rel/ - Stable release tarballs

If you are a downstream consumer of DPDK and would like to influence how the
Stable/LTS releases are working, or should work, then let us know.

John
  
Thomas Monjalon Jan. 13, 2017, 4:29 p.m. UTC | #2
2017-01-13 13:14, Mcnamara, John:
> Just a reminder that DPDK 16.07 was a stable release, 16.11 is a stable
> release and it will also become the 2 year LTS release.

There should be a roadmap for the stable releases,
giving end of life dates.

What about updating this page? http://dpdk.org/dev/roadmap
  
John McNamara Jan. 13, 2017, 5:57 p.m. UTC | #3
> -----Original Message-----
> From: Thomas Monjalon [mailto:thomas.monjalon@6wind.com]
> Sent: Friday, January 13, 2017 4:29 PM
> To: Mcnamara, John <john.mcnamara@intel.com>
> Cc: dev@dpdk.org; Liu, Yuanhan <yuanhan.liu@intel.com>
> Subject: Re: [PATCH v1] doc: add guidelines on stable and lts releases
> 
> 2017-01-13 13:14, Mcnamara, John:
> > Just a reminder that DPDK 16.07 was a stable release, 16.11 is a
> > stable release and it will also become the 2 year LTS release.
> 
> There should be a roadmap for the stable releases, giving end of life
> dates.
> 
> What about updating this page? http://dpdk.org/dev/roadmap

Good point. That was planned. We'll look at pushing up a patch to the Roadmap page.

John
  
Thomas Monjalon Feb. 8, 2017, 12:24 p.m. UTC | #4
2017-01-13 13:06, John McNamara:
> Add document explaining the current Stable and LTS process.
> 
> Signed-off-by: John McNamara <john.mcnamara@intel.com>

Acked-by: Thomas Monjalon <thomas.monjalon@6wind.com>

Applied, thanks
  

Patch

diff --git a/doc/guides/contributing/index.rst b/doc/guides/contributing/index.rst
index f6af317..329b678 100644
--- a/doc/guides/contributing/index.rst
+++ b/doc/guides/contributing/index.rst
@@ -10,4 +10,5 @@  Contributor's Guidelines
     versioning
     documentation
     patches
+    stable
     cheatsheet
diff --git a/doc/guides/contributing/stable.rst b/doc/guides/contributing/stable.rst
new file mode 100644
index 0000000..735e116
--- /dev/null
+++ b/doc/guides/contributing/stable.rst
@@ -0,0 +1,99 @@ 
+.. stable_lts_releases:
+
+DPDK Stable Releases and Long Term Support
+==========================================
+
+This section sets out the guidelines for the DPDK Stable Releases and the DPDK
+Long Term Support releases (LTS).
+
+
+Introduction
+------------
+
+The purpose of the DPDK Stable Releases is to maintain releases of DPDK with
+backported fixes over an extended period of time. This provides downstream
+consumers of DPDK with a stable target on which to base applications or
+packages.
+
+The Long Term Support release (LTS) is a designation applied to a Stable
+Release to indicate longer term support.
+
+
+Stable Releases
+---------------
+
+Any major release of DPDK can be designated as a Stable Release if a
+maintainer volunteers to maintain it.
+
+A Stable Release is used to backport fixes from an ``N`` release back to an
+``N-1`` release, for example, from 16.11 to 16.07.
+
+The duration of a stable is one complete release cycle (3 months). It can be
+longer, up to 1 year, if a maintainer continues to support the stable branch,
+or if users supply backported fixes, however the explicit commitment should be
+for one release cycle.
+
+The release cadence is determined by the maintainer based on the number of
+bugfixes and the criticality of the bugs. Releases should be coordinated with
+the validation engineers to ensure that a tagged release has been tested.
+
+
+LTS Release
+-----------
+
+A stable release can be designated as an LTS release based on community
+agreement and a commitment from a maintainer. An LTS release will have a
+maintenance duration of 2 years.
+
+The current DPDK LTS release is 16.11.
+
+It is anticipated that there will be at least 4 releases per year of the LTS
+or approximately 1 every 3 months. However, the cadence can be shorter or
+longer depending on the number and criticality of the backported
+fixes. Releases should be coordinated with the validation engineers to ensure
+that a tagged release has been tested.
+
+
+What changes should be backported
+---------------------------------
+
+Backporting should be limited to bug fixes.
+
+Features should not be backported to stable releases. It may be acceptable, in
+limited cases, to back port features for the LTS release where:
+
+* There is a justifiable use case (for example a new PMD).
+* The change is non-invasive.
+* The work of preparing the backport is done by the proposer.
+* There is support within the community.
+
+
+The Stable Mailing List
+-----------------------
+
+The Stable and LTS release are coordinated on the stable@dpdk.org mailing
+list.
+
+All fix patches to the master branch that are candidates for backporting
+should also be CCed to the `stable@dpdk.org <http://dpdk.org/ml/listinfo/stable>`_
+mailing list.
+
+
+Releasing
+---------
+
+A Stable Release will be released by:
+
+* Tagging the release with YY.MM.n (year, month, number).
+* Uploading a tarball of the release to dpdk.org.
+* Sending an announcement to the `announce@dpdk.org <http://dpdk.org/ml/listinfo/announce>`_
+  list.
+
+Stable release are available on the `dpdk.org download page <http://dpdk.org/download>`_.
+
+
+ABI
+---
+
+The Stable Release should not be seen as a way of breaking or circumventing
+the DPDK ABI policy.