Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from phobos.denx.de (phobos.denx.de [85.214.62.61]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id D50FBC433EF for ; Tue, 12 Jul 2022 21:34:28 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 4F211841C3; Tue, 12 Jul 2022 23:34:26 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=konsulko.com header.i=@konsulko.com header.b="J7o9bW1z"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id E3085841D7; Tue, 12 Jul 2022 23:34:24 +0200 (CEST) Received: from mail-qk1-x733.google.com (mail-qk1-x733.google.com [IPv6:2607:f8b0:4864:20::733]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 1FE98841C2 for ; Tue, 12 Jul 2022 23:34:21 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=konsulko.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=trini@konsulko.com Received: by mail-qk1-x733.google.com with SMTP id q13so2178043qkc.9 for ; Tue, 12 Jul 2022 14:34:21 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=konsulko.com; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=qlg/ccYfLcIaOu891xBBSFFgpdnBnupektiyVUdATgI=; b=J7o9bW1zxz/18qaOL7oRRxANtvvDQKrDzxGHYopw+9rqSW2TgU1jyo/3p2mLj6PP43 3Ll6L34SpZ2r6ez+Wphh3/ETtwNWGhpUaKZKDc0WMLH2SfiE89IV2/EVd9Yp08FNsa04 MW7ATdyphs1B9iPTjTm8Ck/wnO2iv+SL2qVcM= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=qlg/ccYfLcIaOu891xBBSFFgpdnBnupektiyVUdATgI=; b=zTfK4VEPjyVYa83U6Y562qLicFxghYVbuZtkDGiDwyZKcbELeAYNhoz2kK4R08Ih6U OnjlEW7iD1Q0j6peIZ4tki2yGuH2O4ih4as/j1KS+L4qJ2Du01gVapCdczh1octTWor9 YulX6jglF/LiHL/PDxFp9VBtR3vw/2BdaBWEUKHyH2rFBLhn6hgFqYvIEj3Cz6vLX4q9 +uQOATzFuQR399Y9Qqx81WYtyXn7f0nuMbw/mC5GESH+VYFA+HNGOO47PqCvsU+XM0OO Us1WjFZGAm+YCSFt2FABbcVWya9RBkbWxpDW9kSyHtqHmOO70TKJ/Z35OybTbf8SB77W OKYw== X-Gm-Message-State: AJIora++lsvjlMfETiM0+i8vn7r1bFRzmb98R8n310IRuzzaZRiQbxK2 EyCeJCb5vwuPFSX3Ksq1zPoVqUoRcNLfiQ== X-Google-Smtp-Source: AGRyM1vnX5/wQ+vRImNGzGqeFeTfoUL9PMe1TeH7r4kiO0AJMaSieEDCdOy9O2g5MX0PmVhEbooF0w== X-Received: by 2002:a05:620a:2456:b0:6b5:9210:163f with SMTP id h22-20020a05620a245600b006b59210163fmr267609qkn.136.1657661659436; Tue, 12 Jul 2022 14:34:19 -0700 (PDT) Received: from bill-the-cat.lan (cpe-65-184-195-139.ec.res.rr.com. [65.184.195.139]) by smtp.gmail.com with ESMTPSA id x18-20020a05620a449200b006a981a2c483sm10995476qkp.39.2022.07.12.14.34.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 12 Jul 2022 14:34:19 -0700 (PDT) From: Tom Rini To: u-boot@lists.denx.de Cc: Heinrich Schuchardt Subject: [v3 2/4] doc: Add doc/develop/release_cycle.rst Date: Tue, 12 Jul 2022 17:34:14 -0400 Message-Id: <20220712213416.3200979-2-trini@konsulko.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220712213416.3200979-1-trini@konsulko.com> References: <20220712213416.3200979-1-trini@konsulko.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.103.6 at phobos.denx.de X-Virus-Status: Clean 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 Signed-off-by: Tom Rini --- 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 +`_, which was originally created by +Jonathan Corbet. + +* :doc:`statistics/u-boot-stats-v2022.07` which was released on 11 July 2022. -- 2.25.1