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 140B0C43334 for ; Tue, 12 Jul 2022 15:49:06 +0000 (UTC) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id CAABF8418E; Tue, 12 Jul 2022 17:49:02 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=reject dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (2048-bit key; unprotected) header.d=seco.com header.i=@seco.com header.b="AvMFUenB"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id 272298418E; Tue, 12 Jul 2022 17:49:00 +0200 (CEST) Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2089.outbound.protection.outlook.com [40.107.21.89]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id DDAED840EC for ; Tue, 12 Jul 2022 17:48:55 +0200 (CEST) Authentication-Results: phobos.denx.de; dmarc=pass (p=reject dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=sean.anderson@seco.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=P4ul3DhxR/SvLs/XRAl95sZ8VO3NVdk8uuVxf9qBhVP85AcYc+Gr7rHmntsKl7VqK7HZtRUYzDssAXDBFzNBpExc++VkTudGKRZvye8GVGdTogda5uSFvQyHkCSMnOqvnooIY9o03WRYY1FYRFb6wIRwfAeu1ZVK6WlYadQvmMh0JTJ1Z4RVAzyG27uwJhqPwucsOqDH+zdoesXN1BPz8SF2BTw5fOKnSkXMTl6+Vq9sI8lO3lJc07L92dpkQyXj7q0+YWRhlCSKke9phhghHgmD9u9Ylvoq8UfRUbxNtr6WlJQ93eWLj3BWoMUWAUYL+g9hd8XQnx/Ub1vib+VtNQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=R0MVTel5n5XVkvIjLo00X3msLVmr7oPMwntttqfXZ5I=; b=TeE6HQWW6mGmFeS3nSeGvOSwKgX5TzEoxqjT8J6QMRKRe49VSil8foocCnjnGUswPuPO8Eqe9eVs8j0QyrfuTxKWLUMThlxw8YRCVcBpP4jAw1YdmVew6jSeErKpI9cFpWnH+ft24mkJougkY3HKFjGOawn9WBnDmwBMg6CI6CKB5DJSSJGhL+lHPUeJm2brKGxVVIIz4OG8lO9XFUe1eHPdVrKMWoUpySsM8v/82bTICT5t4p9we5OoFi68w8VHqBx5UsI/+J0IWNWQ2W74HU7PPnIx79mDDJij1q41zkpAEFY5baqLlmEdXTaWIs6e7Oe33fshbwfDFr/Buabh6g== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=seco.com; dmarc=pass action=none header.from=seco.com; dkim=pass header.d=seco.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=seco.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=R0MVTel5n5XVkvIjLo00X3msLVmr7oPMwntttqfXZ5I=; b=AvMFUenBQPrqGC9/IGbvCz5AyyqYA7b84wsVqdeeyiL2LHPyuoYrvPqTqoW0G2ogGV2RSQIWLZIdGSBhcVCyoKx3sAjHi3dIFwsXJ3CXDVmi3A15Bjz7qNHtkNj2YB+P2eBpWKHGOahwyyngO88LlJfBc5997QuKaQRIOfOcRQyyd7UJ+8IPyD781WPqJUhrALHIzrXT+d3bNogLmhHdiN1FM7FaoONQDSCyXkGVoE/Wyqfn8Pm0nuUcvoUmUr6979QBYBOzcN9zHUgv2DMlccLC2SMpVdi6lP4nP7U3PbMNqcnVxCLuByWlCtUq8gvOrVbhyPhbRRI9TGgv60/Xag== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=seco.com; Received: from DB7PR03MB4972.eurprd03.prod.outlook.com (2603:10a6:10:7d::22) by DB7PR03MB3866.eurprd03.prod.outlook.com (2603:10a6:5:30::28) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5417.26; Tue, 12 Jul 2022 15:48:53 +0000 Received: from DB7PR03MB4972.eurprd03.prod.outlook.com ([fe80::757e:b75f:3449:45b1]) by DB7PR03MB4972.eurprd03.prod.outlook.com ([fe80::757e:b75f:3449:45b1%6]) with mapi id 15.20.5417.026; Tue, 12 Jul 2022 15:48:53 +0000 Subject: Re: [RFCv2 2/2] doc: Add doc/develop/release_cycle.rst To: Tom Rini , u-boot@lists.denx.de Cc: Heinrich Schuchardt References: <20220712153300.3077560-1-trini@konsulko.com> <20220712153300.3077560-2-trini@konsulko.com> From: Sean Anderson Message-ID: Date: Tue, 12 Jul 2022 11:48:49 -0400 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.10.0 In-Reply-To: <20220712153300.3077560-2-trini@konsulko.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 7bit X-ClientProxiedBy: BL1P223CA0011.NAMP223.PROD.OUTLOOK.COM (2603:10b6:208:2c4::16) To DB7PR03MB4972.eurprd03.prod.outlook.com (2603:10a6:10:7d::22) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: d48b8b57-36ef-4736-7a4f-08da641e05a4 X-MS-TrafficTypeDiagnostic: DB7PR03MB3866:EE_ X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 1pDuJBQb6nIPWu17yHLXnYZDcMKflaKmywJZSfH8LXL4hhcYAQarp/gWokICGadVG87zNc6OB2kfPoxTYUhqSX1NTLu+61YQyM85UX68NpPUVz8zE8FlTyAgAWPJYsNj0IZp5gkSW68e0h5wgJpRh6DwnhueXoZd4wIGXwSzS6aZLH3k4/zWA4kg7+k1W4n4HNkeqNWp0iqX38ZbA44hTp4xE5cGwiAryyXs3hNyZn+ouzYw7JwvLQz4fqAu5OXNoONeJKohwNjlxJU938aL5AyyYHWtAEhjHK2DdDKq9JzMzGjI74H4Em/rOC2BwPVUis5UnMnxBLmRgX49Rxl/jVDxgyQpQfVhxcP1VLtXMWf8pGaf2RFY/eTVHd46ZuO9IJ3zUQHwQvGFwjVFz64qH+Njn04hCMjVo5jaRhG/61tDDigOOREoVUyFG6kcOZJ5mYKPJM55MFG6UvQ269ByXDh4hCV2O917Nu6sFVw8qq1+OrGzj7LsZEsCtOnSUvvhLsT3mRIlthqVzZgj8FNYPVM8pzxKi6wMSMzS0MWowh6eqU0GrxrGy5P2ml2WaEM6xZWBFDXvm/P1V5KAiIXsHPnPR9L5pLUT0Gzah9cLjnBmuhmmNMfKM7qBMOxQsKbSc0x5lmebilyhMS85fBs80tLUmp8AmvgdKYfyBlw+ZTe/1Ii9gydDb0qDJBnYFCNcrQVZbbQTF28JmMKsfHqgzoQ5b4Qa3LPwF1XcKIJ5zKKdNetVuILGhc5uMJMq+xIWNhAxhA9KBY/7zgpNJVXjbitWQUi5gUtCSMTI0gqp9iQUydR4XFDTZi3LOUcBZegEKecp1PJRYaU0xxG+mb3/43vEZX2gaJDfR31DZNyfJN/BgeOM1pZqzIiQFulycRalu4smOx3wSQ7jFTKboSUS2w== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DB7PR03MB4972.eurprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230016)(136003)(376002)(396003)(366004)(346002)(39850400004)(36756003)(86362001)(31696002)(5660300002)(53546011)(31686004)(6512007)(26005)(186003)(38350700002)(52116002)(38100700002)(8676002)(83380400001)(6506007)(41300700001)(66946007)(4326008)(2616005)(66476007)(8936002)(44832011)(66556008)(2906002)(6486002)(478600001)(6666004)(316002)(43740500002)(45980500001); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?cWc0bXFKTTJtNkJMMkdicUN0VUpZcDJVR2t5TXdTOVpjSkVDd3kwdHB3M2FF?= =?utf-8?B?VGRqTng2Rjl4R0xvUFFldVBHaGRUc1djYmlWd090aVJHbzVLY3YrMys2Q28r?= =?utf-8?B?WGs0ZTFIbEV6aGk4cnJFNlp5TjZOQ0JEbmpHcVZxektZWldyRWtmbXZCOTBM?= =?utf-8?B?UEFpbnpyWTdwTHkrb24zNW5QaHJGVkVWbU4wYnNrNk1EbkVDTDc2d2lHUmow?= =?utf-8?B?M2lRaWdUUXNmM3hZdW54Mmh2VFFnT0VtL0I0YTFUQmRvbHFtd3kyVlUvbHRp?= =?utf-8?B?OG1vdUd4WGdUWU1mZlFyZ1dYODlvMkpyQlRxTU1LTTh1YjJ5MjdFV0JKeFJN?= =?utf-8?B?U2VRNW5qQ2t4U3M5NEhOcWZIUnNpODhyYkphemcvNUZPVUdmcktoOUVlR2o2?= =?utf-8?B?c0NFRUlKdFpiUlFjZkNER1lyQjNzWnY1UUM4NGp1bFF3VFZxdnZGWmhOYlEx?= =?utf-8?B?dCs0akVXMUFXcFl6RzY0YmdmWnV1YlA5UTJiRVZlSVpiaHc5VnJraHlrVjdG?= =?utf-8?B?OU1lWHZZUVlJOFNza3ovblorVlhvaXFQL0ttUTVSc3l4Y0grR3FSOTF2UlNP?= =?utf-8?B?U0NnMExud1UyVitib1FvMUlDVEMzTHBCUXNmRWFVQ2Z0TTgxdXVGZnFScDhB?= =?utf-8?B?a1dMT2ZYMEZQZWZMY0huMUc1Z1Ixb1lUcnJmTW9wUnFZeTQvRE15OURJeVg0?= =?utf-8?B?bkptWHhzam9iQUZkQ1p3NHkraVZCSG80QVVweERwSFRWQjNQYXc5QzQyNVhp?= =?utf-8?B?V0NXd3VIVWdHMDJ3V0JVME40ZncvZTN0NGdhUm5IUW4wK1JUcUZxRllpWnhm?= =?utf-8?B?bTVKc3dEUHdUVFFBZU9sTVFWUE5SbFQzZkdremtxOU95TzFLc1dxY25UU0ps?= =?utf-8?B?VDAwYnE4bjVuSjVqbHBJWkhRanlDMDc3S2FIWHZiaTVOUFVDNk11YU9wWVZk?= =?utf-8?B?WmMvanhYeUJyMmI2ZExZWmpsR3N1R0gyNjFVa0xoM2tTKytYcEd2SE80cU9C?= =?utf-8?B?dzRIbU9VUWx4K0RqejVsTGdwRW1GWmFqRzJsczdDTXc1TTFiU3FUSkxXcGdp?= =?utf-8?B?OE10VS80RExyOTkxNWZ0a3VyMm5TWFhIVVJzYk4wL3p5YVBLV3Y0dEZVQ1Mx?= =?utf-8?B?c3pHRkZzS0tWd0MvSVdvc0FtblUvZUpxdUVZb0NOKzR5T2tENTFpbVFzTDlY?= =?utf-8?B?eFZMTllHWUpMQXExTkJoRkdRclpDZWd6NlkwN0RNUzFxak9pWjA4NllhNVhk?= =?utf-8?B?U29Xb0RoblYxbkZET0JhVm56a2hRR1IvVTBqdElvTklydVl2QUNGNHRKR3pz?= =?utf-8?B?Wkhjb3BRZmsyM1BDTU9GY2pQcVE4UFc2OEk2VlhsVTVjZ3h0azByWVlxQ0ox?= =?utf-8?B?SStHNzBhKyt2T09Qd3YyWlVoWTN0cFplR2ZwcjZFeHpleEhoZWcxYXU0Q1Vv?= =?utf-8?B?S2dQSVlpRHFqank1eW9ma3FJV1hraExVWmwzejBiQnptS2IvQmVnbE0ybEVr?= =?utf-8?B?YVZEZzVPZlpiOVNJZkhiRkdSWEtqd3JMZC96NTJjK3RhcWwyYWlVbk84Rzdp?= =?utf-8?B?YjVaa1hobWVITlZZVG9zMFhIQlM0MWpxc3RkdWJOWmo4UVU2V3ZOVlg0N0Zr?= =?utf-8?B?d2ZyMTVLOGFPdmk5a1dlMktrMk90TGpUL0ZxVDRzTC9YeWFFajlYYVVIUjAx?= =?utf-8?B?UmxIVUc4ejRWYWhwL1NkbklLa000cXJmSWprTDRFUU1xdmk2ZE9DS2JkNER2?= =?utf-8?B?VFBkcGxCKzBpZGVreUlDOXo2bTJrY3VIR25WSE9MTnR1UUYzNnNFcDJiOUVE?= =?utf-8?B?NllFNnhRUnNYdXJKbGhVVUMxNmU4OEpLVXdydm1NWjBIM1EzQUllK0NaT250?= =?utf-8?B?cUFBQWNqbGFKTGFWeDJSM0V2RFZ1Y1BmbEdtOXUwWk10blhiZUdBS3BUaWxB?= =?utf-8?B?Z0ZsWlVoTVlEMkZIa0EzZ0JJbWdZMS93bURrZCtiZ2hOSWt1LzhkUzJhdVkr?= =?utf-8?B?OVFNRmtvUVVjdE1YbnoxaTNmZUxJZ3AzUGVqNDdJM250OTFVZlJMRWgwVTA5?= =?utf-8?B?ZW1mOWMrRVFQOFRSQ1hwMHBxdk5ibmVrUXYrSUFBZ21qM1F2aGZCZ2xYTUkz?= =?utf-8?B?VjFGMVorVVlKQ0hmaXF0SmhZcjRseWZnVHdVcWZqMHFwZ3ZjUmdJNXZYb3hW?= =?utf-8?B?N0E9PQ==?= X-OriginatorOrg: seco.com X-MS-Exchange-CrossTenant-Network-Message-Id: d48b8b57-36ef-4736-7a4f-08da641e05a4 X-MS-Exchange-CrossTenant-AuthSource: DB7PR03MB4972.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 12 Jul 2022 15:48:53.4058 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: bebe97c3-6438-442e-ade3-ff17aa50e733 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: tIJI30oqR/EhLpES0c4Pz9B+MhgN2LC2AB+xYfikgXQiQTLwo3WKKGWK9X2MoWAXo8P7DxNrf3/R8HDHnlJTfw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB7PR03MB3866 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 Hi Tom, On 7/12/22 11:33 AM, Tom Rini wrote: > 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 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 | 95 +++++++++++++++++++++++++++++++++++ > 2 files changed, 96 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..dbaaa7210c4e > --- /dev/null > +++ b/doc/develop/release_cycle.rst > @@ -0,0 +1,95 @@ > +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 a Monday around mid-month. I thought you aimed for the first Monday? This is what is stated below as well. > +* 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. Linus Torvalds explains `here > + `_ and `there > + `_ what the > + term "merge window" is supposed to mean. I think a link to the process page would be better here. > +* 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 may respects, nit: many > +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 (if > +present) indicate release candidates or bug fix releases in "stable" > +maintenance trees. > + > +Examples:: > + > + U-Boot v2009.11 - Release November 2009 > + U-Boot v2009.11.1 - Release 1 in version November 2009 stable tree From what I can tell, point releases are very unusual, except for bugs which break booting (notably excluding security fixes). I believe the lack of point releases is due to lack of need (since most vendors have their own branch) and lack of bandwidth. A note here about this would be nice. > + 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 > +--------------- > + > +.. * 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. Will be? Maybe it's better to use a past release for this if you want to use concrete dates. > +Please note that the following dates are for information only and without > +responsibility: > + > +.. Release date: Generally first Monday of the month > +.. End of MW = Release Date + 21 d = 3rd Monday of the month > + > +* "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. > --Sean