From: Thorsten Leemhuis <linux@leemhuis.info>
To: Jonathan Corbet <corbet@lwn.net>,
workflows@vger.kernel.org, regressions@lists.linux.dev,
linux-doc@vger.kernel.org
Cc: Linus Torvalds <torvalds@linux-foundation.org>,
Greg KH <gregkh@linuxfoundation.org>
Subject: [PATCH v1 0/6] docs: add instruction about handling regressions to our core texts for contributors
Date: Tue, 10 Dec 2024 11:15:09 +0100 [thread overview]
Message-ID: <cover.1733825632.git.linux@leemhuis.info> (raw)
Add some more detailed instruction on handling regressions to our core
texts for contributors, e.g. Documentation/process/6.Followthrough.rst
and Documentation/process/submitting-patches.rst. This was asked for at
the last Maintainer Summit[1] and is meant to help clarifing what's
expected.
The added instructions are somewhat inspired by existing and sometimes
similar text in Documentation/process/handling-regressions.rst which is
semoved during the series.
The patch-set starts with some basics, which are based on the existing
text or recent statements from Linus. I tried to stay close to what was
said, but used my own words here -- if I got something wrong just tell
me so I can fix this.
The guidelines then are extended in multiple steps to cover more things
and be more specific in some areas. Some of that is meant to work
against problems I noticed during my regression tracking work. Most of
these are my words. These thus need to be discussed properly and in the
end ideally ACKed by Linus, so we all know what he wants. The parts I
expect to get more discussion are found near the end of the patchset.
Link: https://lwn.net/Articles/990599/ [1]
Signed-off-by: Thorsten Leemhuis <linux@leemhuis.info>
---
v1:
- initial version
Thorsten Leemhuis (6):
docs: more detailed instructions on handling regressions
docs: 6.Followthrough.rst: when to involved Linus in regressions
docs: 6.Followthrough.rst: interaction with stable wrt to regressions
docs: 6.Followthrough.rst: tags to use in regressions fixes
docs: 6.Followthrough.rst: more specific advice on fixing regressions
docs: 6.Followthrough.rst: advice on handling regressions fixes
Documentation/process/6.Followthrough.rst | 152 ++++++++++++++++--
.../process/handling-regressions.rst | 111 +------------
Documentation/process/submitting-patches.rst | 20 +++
3 files changed, 157 insertions(+), 126 deletions(-)
base-commit: 010a08cbf0d63b246c4cd0d385c3f664add2322d
--
2.45.0
next reply other threads:[~2024-12-10 10:15 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-12-10 10:15 Thorsten Leemhuis [this message]
2024-12-10 10:15 ` [PATCH v1 1/6] docs: more detailed instructions on handling regressions Thorsten Leemhuis
2024-12-13 16:14 ` Jonathan Corbet
2024-12-20 12:17 ` Thorsten Leemhuis
2024-12-10 10:15 ` [PATCH v1 2/6] docs: 6.Followthrough.rst: when to involved Linus in regressions Thorsten Leemhuis
2024-12-13 16:17 ` Jonathan Corbet
2024-12-20 12:41 ` Thorsten Leemhuis
2024-12-10 10:15 ` [PATCH v1 3/6] docs: 6.Followthrough.rst: interaction with stable wrt to regressions Thorsten Leemhuis
2024-12-13 16:20 ` Jonathan Corbet
2024-12-20 13:13 ` Thorsten Leemhuis
2024-12-10 10:15 ` [PATCH v1 4/6] docs: 6.Followthrough.rst: tags to use in regressions fixes Thorsten Leemhuis
2024-12-13 16:24 ` Jonathan Corbet
2024-12-20 13:18 ` Thorsten Leemhuis
2024-12-10 10:15 ` [PATCH v1 5/6] docs: 6.Followthrough.rst: more specific advice on fixing regressions Thorsten Leemhuis
2024-12-13 16:28 ` Jonathan Corbet
2024-12-20 14:21 ` Thorsten Leemhuis
2024-12-10 10:15 ` [PATCH v1 6/6] docs: 6.Followthrough.rst: advice on handling regressions fixes Thorsten Leemhuis
2024-12-13 16:30 ` Jonathan Corbet
2024-12-20 14:24 ` Thorsten Leemhuis
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=cover.1733825632.git.linux@leemhuis.info \
--to=linux@leemhuis.info \
--cc=corbet@lwn.net \
--cc=gregkh@linuxfoundation.org \
--cc=linux-doc@vger.kernel.org \
--cc=regressions@lists.linux.dev \
--cc=torvalds@linux-foundation.org \
--cc=workflows@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox