summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorAntonin Godard <antonin.godard@bootlin.com>2026-01-05 17:00:59 +0100
committerRichard Purdie <richard.purdie@linuxfoundation.org>2026-01-26 09:41:31 +0000
commit0da3cd0ae6364062449c2aecdc043f603af1d2df (patch)
tree4defc342577070acf7a6f5bd74a8ac01e8d3c726 /documentation
parent41ab4d1168dc55225ac941cc6fb5a319ef92f7b6 (diff)
downloadpoky-0da3cd0ae6364062449c2aecdc043f603af1d2df.tar.gz
ref-manual/release-process.rst: add a "Development Cycle" section
Add a new section to release-process.rst to document the development cycle of each release and namely the milestones and feature freeze occuring after M3. Fixes [YOCTO #15979] (From yocto-docs rev: 1cc5321c162ce36079d661ea1d35c2694c20ed9b) Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> (cherry picked from commit 77c04cc5944acda7575546a7434e014e4a75ba58) Signed-off-by: Antonin Godard <antonin.godard@bootlin.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/release-process.rst39
1 files changed, 39 insertions, 0 deletions
diff --git a/documentation/ref-manual/release-process.rst b/documentation/ref-manual/release-process.rst
index 8263548448..165dfb86d6 100644
--- a/documentation/ref-manual/release-process.rst
+++ b/documentation/ref-manual/release-process.rst
@@ -45,6 +45,45 @@ release process validates the content of the new branch.
45 Realize that there can be patches merged onto the stable release 45 Realize that there can be patches merged onto the stable release
46 branches as and when they become available. 46 branches as and when they become available.
47 47
48.. _ref-yp-development-cycle:
49
50Development Cycle
51=================
52
53As explained in the previous :ref:`ref-manual/release-process:Major and Minor
54Release Cadence` section, a new release comes out every six months.
55
56During this six-months period of time, the Yocto Project releases four
57"Milestone" releases which represent distinct points of time. The milestone
58releases are tested through the :ref:`ref-manual/release-process:Testing and
59Quality Assurance` process and helps spotting issues before the actual release
60is out.
61
62The time span between milestone releases can vary, but they are in general
63evenly spaced out during this six-months period of time.
64
65These milestone releases are tagged with a capital "M" after the future release
66tag name. For example, the milestone tags "&DISTRO_RELEASE_SERIES;M1",
67"&DISTRO_RELEASE_SERIES;M2", and "&DISTRO_RELEASE_SERIES;M3" are released before
68the actual "&DISTRO_RELEASE_SERIES;" release.
69
70.. note::
71
72 The fourth milestone (M4) is not actually released and announced, but
73 represents a point of time for the Quality Assurance team to start the
74 :ref:`ref-manual/release-process:Testing and Quality Assurance` process
75 before tagging and delivering the final release.
76
77After the third milestone release (M3), the Yocto Project enters **Feature
78Freeze**. This means that the maintainers of :term:`OpenEmbedded-Core
79(OE-Core)`, :term:`BitBake` and other core repositories stop accepting
80significant changes on the "master" branch. Changes that may be accepted are
81minor upgrades to core components and security/bug fixes.
82
83During feature freeze, a new branch is created and maintained separately to
84test new features and enhancements received from contributors, but these changes
85will only make it to the master branch after the release is out.
86
48Major Release Codenames 87Major Release Codenames
49======================= 88=======================
50 89