[v3 2/4] doc: Add doc/develop/release_cycle.rst
Tom Rini
trini at konsulko.com
Tue Jul 12 23:34:14 CEST 2022
Migrate the RelaseCycle wiki page to Sphinx. In terms of visible
changes, we stop having a dynamic countdown to when the release is. And
we drop the year-based statistics, that were not being kept up to date.
For the moment, we only link to statistics for v2022.07 but will add
back the historical data in a subsequent patch.
Cc: Heinrich Schuchardt <xypron.glpk at gmx.de>
Signed-off-by: Tom Rini <trini at konsulko.com>
---
Changes in v3:
- Minor rewords per Sean, on when we do point releases and about what
the merge window means.
- Minor rewords per Heinrich, and try and make it clearer about why we
have commented out rcN lines for the next release.
- Note that I have completed migration of all of the other stats pages,
but as a single commit it is nearly 2MiB. This is visible at
https://source.denx.de/u-boot/u-boot/-/commit/3d8cfed0078365c2b6261d5a4ea7145b43e6ba8d
and we'll need to figure out the best way to pull that in to a tree as I
don't plan to allow that to get posted to the list due to excessive
size.
Changes in v2:
- New patch. Note that I'm not including the v1.3.0 to v2022.04 stats
here as while I can generate them, I want to make sure we're happy
with how v2022.07 ones look as there is some manual effort involved.
It's a reasonable amount of manual effort however for a single release.
---
doc/develop/index.rst | 1 +
doc/develop/release_cycle.rst | 94 +++++++++++++++++++++++++++++++++++
2 files changed, 95 insertions(+)
create mode 100644 doc/develop/release_cycle.rst
diff --git a/doc/develop/index.rst b/doc/develop/index.rst
index eab00a55382a..73741ceb6a2f 100644
--- a/doc/develop/index.rst
+++ b/doc/develop/index.rst
@@ -12,6 +12,7 @@ General
codingstyle
designprinciples
process
+ release_cycle
Implementation
--------------
diff --git a/doc/develop/release_cycle.rst b/doc/develop/release_cycle.rst
new file mode 100644
index 000000000000..ed11f15b9297
--- /dev/null
+++ b/doc/develop/release_cycle.rst
@@ -0,0 +1,94 @@
+Release Cycle
+=============
+
+The U-Boot projects attempts to maintain a fixed, predictable Release
+Cycle as follows:
+
+* We will have U-Boot releases at a fixed release interval of (approximately)
+ every 3 months.
+
+* Under normal conditions the release date will be the first Monday of the month.
+
+* Immediately following each release, there will be a "merge window" of
+ normally 21 days, i. e. if the release was on a Monday, then the merge window
+ will close on the Monday in the 3rd week after the release.
+
+ While this merge window is open, new features can be added to the U-Boot
+ source tree. This is further expanded on in the :doc:`process`.
+
+* After the merge window closes, no new features may be added to allow for a
+ release candidate phase which is intended to fix bugs and regressions.
+
+*Note:* While we try to adhere to the release schedule, we will
+not hesitate and take the liberty to delay a release if there are
+good reasons, for example if there are known bugs or other technical
+reasons. The code will be released when it is considered ready
+without caring too much about the announced deadline.
+
+*Note 2:* Even though we follow Linux ways in many respects, there are
+differences in the actual procedures, which are documented in the
+:doc:`process`.
+
+Version Numbers
+---------------
+
+Starting with the release in October 2008, the names of the releases were
+changed from numerical release numbers without deeper meaning into a time stamp
+based numbering. Regular releases are now identified by names consisting of
+the calendar year and month of the release date. Additional fields are
+frequently used to denote the release candidates. They are also used on rare
+occasions to note a bug fix release on top of the previous stable release.
+
+Examples::
+
+ U-Boot v2009.11 - Release November 2009
+ U-Boot v2009.11.1 - Bug fix release 1 on top of the November 2009 release
+ U-Boot v2010.09-rc1 - Release candidate 1 for September 2010 release
+
+Current Status
+--------------
+
+* U-Boot v2022.07 was released on Mon 11 July 2022.
+
+* The Merge Window for the next release (v2022.10) is **open** until -rc1
+ release on Mon 25 July 2022.
+
+* Release "v2022.10" is scheduled for 03 Oct 2022.
+
+Future Releases
+---------------
+
+.. The following commented out dates are for when release candidates are
+ planned to be tagged.
+
+.. For the next scheduled release, release candidates were made on::
+
+.. * U-Boot v2022.10-rc1 was released on Mon 25 July 2022.
+
+.. * U-Boot v2022.10-rc2 was released on Mon 08 August 2022.
+
+.. * U-Boot v2022.10-rc3 was released on Mon 22 August 2022.
+
+.. * U-Boot v2022.10-rc4 was released on Mon 05 September 2022.
+
+.. * U-Boot v2022.10-rc5 was released on Mon 19 September 2022.
+
+Please note that the following dates are planned only and may be deviated from
+as needed.
+
+* "v2022.10": end of MW = Mon, Jul 25, 2022; release = Mon, Oct 03, 2022
+
+* "v2023.01": end of MW = Mon, Oct 24, 2022; release = Mon, Jan 09, 2023
+
+* "v2023.04": end of MW = Mon, Jan 30, 2022; release = Mon, Apr 03, 2023
+
+* "v2023.07": end of MW = Mon, Apr 24, 2023; release = Mon, Jul 03, 2023
+
+Previous Releases
+-----------------
+
+Note: these statistics are generated by our fork of `gitdm
+<https://source.denx.de/u-boot/gitdm>`_, which was originally created by
+Jonathan Corbet.
+
+* :doc:`statistics/u-boot-stats-v2022.07` which was released on 11 July 2022.
--
2.25.1
More information about the U-Boot
mailing list