Received: by 2002:a05:6359:6284:b0:131:369:b2a3 with SMTP id se4csp825500rwb; Sat, 5 Aug 2023 01:39:05 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFplsHhuJn+oWuIo6W/9szFU9+py3A78Zg+KMGezccev74kUy//LISiDKh60GzVvwYcEVWF X-Received: by 2002:a05:6a20:970a:b0:137:293b:f9c0 with SMTP id hr10-20020a056a20970a00b00137293bf9c0mr3687481pzc.33.1691224745120; Sat, 05 Aug 2023 01:39:05 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1691224745; cv=none; d=google.com; s=arc-20160816; b=okZDLhAQFrhWlyq/VgvWHuSbBpEfiuciSX4LbeU4aTlxMb7P+Fr1JBAq6gwwqfBMnq OFYvey2XXuWXnhOkdj1QUJLqgYSQj4L6kCT/bGKiOQEHetN5i3d0/c3lWIrVzRx9CSMW McPOB9Njsluw2fiCHqS7CklcYgGXY+8pWSx5XZsRgtXZquZABUn9l1mFSZ5JACHBpdnd DFSWtT4vBBnK+OvwPFU+EaXm/xvBnptv+7Hv6oOoDDGx5kw+UhvCTyXQKtoQyzGVo+dA y08mQ1TkA9F0zyuzXHQD1GWqtOVAdZjjd233my4VUJ4ogSahFf+sUfhc4IhFA3F9cTi/ bX2Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=7J+vlcP2Xc02hcfSJH2LkjPfl9XJU/g9XgEicw0v8Rg=; fh=Dmzbleb+L6iLa20TqVtwh2vhPemd12pKqUGFWsumNXI=; b=lamozd1jjaAYI/hSP7q6M/r9PIU1LPpA1BzFok0jKZ0WS4ak+lsOO1STXUvzlB4PcD NTGMibPCdXaSqJDE6g6XmOs2H6d3AT0+zvv69fniD3N6tMi61xfZzzUSSYfRJP84iBDM gmLf2fRwzCMXIR/zLHGnzqBh/ve0DJpmbBNyfJre6+Y55CqyGr+klFqYWaXKQ6Ng1hA+ HUu8lmHatR4fYRV2kWw7SBOkBGhldpoLik6NwnbadK0A8D6vmYuP+X7JtqqL686sKdpP WOegq7Ftm5UK5tzAwm0HGD/hv34L6vHGAgl4+loJPnvL1ZEfCe32QFrEp5JXc3LFr8EV Qk+g== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id p10-20020a63950a000000b005578023de91si2920510pgd.170.2023.08.05.01.38.53; Sat, 05 Aug 2023 01:39:05 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229818AbjHEHVk (ORCPT + 99 others); Sat, 5 Aug 2023 03:21:40 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43742 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229479AbjHEHVh (ORCPT ); Sat, 5 Aug 2023 03:21:37 -0400 Received: from wp530.webpack.hosteurope.de (wp530.webpack.hosteurope.de [80.237.130.52]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 1107C4EC4; Sat, 5 Aug 2023 00:21:35 -0700 (PDT) Received: from ip4d148da6.dynamic.kabel-deutschland.de ([77.20.141.166] helo=truhe.fritz.box); authenticated by wp530.webpack.hosteurope.de running ExIM with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) id 1qSBbS-0002p2-Cx; Sat, 05 Aug 2023 09:21:34 +0200 From: Thorsten Leemhuis To: Greg KH , stable@vger.kernel.org Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v1 0/5] docs: stable-kernel-rules: improve structure and a few tweaks Date: Sat, 5 Aug 2023 09:21:28 +0200 Message-Id: X-Mailer: git-send-email 2.40.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-bounce-key: webpack.hosteurope.de;linux@leemhuis.info;1691220096;232e9b6a; X-HE-SMSGID: 1qSBbS-0002p2-Cx X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_NONE, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org When adding something to this document earlier I noticed that readers need to perform some back and forth to fully understand things; I also noticed a few other aspects that seemed somewhat odd for me with my background on writing and editing texts. Find attached a few patches to improve things. The first three are mainly moving text around to a structure which is somewhat clearer. They leave quite a few rough edges behind that are fixed in in the last patch of the series, which changes a few other changes as well; thx to the prep patches the diff should be relative straight-forward to understand. These patches are on-top of the following series that currently is in the driver-core-testing branch: https://lore.kernel.org/all/cover.1689056247.git.linux@leemhuis.info/ Ciao, Thorsten v1: * new patch-set based on patch 3/3 and other feedback to the following patchset[1], but slit off into a seperate set with four distinct patches to make it easier to see what is actually changed https://lore.kernel.org/linux-doc/d30686781c47c83927e0a41f6a1167a679fa822c.1689008220.git.linux@leemhuis.info/ * append one more patch for something that came up Thorsten Leemhuis (5): docs: stable-kernel-rules: improve structure by changing headlines docs: stable-kernel-rules: move text around to improve flow docs: stable-kernel-rules: make the examples for option 1 a proper list docs: stable-kernel-rules: fine-tune various details docs: stable-kernel-rules: mention that regressions must be prevented Documentation/process/stable-kernel-rules.rst | 165 ++++++++++-------- 1 file changed, 91 insertions(+), 74 deletions(-) base-commit: 016571b6d52deb473676fb4d24baf8ed3667ae21 prerequisite-patch-id: b00970f680f3032fe8a7d0e3843b76d60c2f0458 prerequisite-patch-id: 9926a13726e99d51800f52cb84e26ae971757467 -- 2.40.1