* [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact
@ 2026-11-16 19:14 Sasha Levin
2026-11-16 19:34 ` Andrew Morton
2026-11-16 19:47 ` Willy Tarreau
0 siblings, 2 replies; 5+ messages in thread
From: Sasha Levin @ 2026-11-16 19:14 UTC (permalink / raw)
To: Jonathan Corbet
Cc: Sasha Levin, Andrew Morton, Shuah Khan, Randy Dunlap,
Greg Kroah-Hartman, Theodore Ts'o, Willy Tarreau, workflows,
linux-doc, linux-kernel
"Describe your changes" already asks for the user-visible impact of a
change, but changelogs for fixes still tend to say what the code does,
why that's wrong and what the patch changes, and stop there. Whoever
has to decide if the fix needs backporting is left to work out what
the bug does to a running system.
Say what that means for a bug fix: describe the worst a user can see
and what it takes to trigger it, say so if the bug was never seen to
happen, and say so if it has no visible effect at all. Give the
paragraph a label so people can be pointed at it.
Coding assistants are told to commit a fix with a message that
describes the problem and the solution. Add the user-visible impact to
that list and point them at the section.
Suggested-by: Andrew Morton <akpm@linux-foundation.org>
Link: https://lore.kernel.org/r/20261111171055.527b4bf3da705367bc78a64c@linux-foundation.org
Signed-off-by: Sasha Levin <sashal@kernel.org>
---
Documentation/process/coding-assistants.rst | 6 ++++--
Documentation/process/submitting-patches.rst | 11 +++++++++++
2 files changed, 15 insertions(+), 2 deletions(-)
diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
index 509dbf23a099b..ef01ce8d0ff91 100644
--- a/Documentation/process/coding-assistants.rst
+++ b/Documentation/process/coding-assistants.rst
@@ -63,8 +63,10 @@ these steps:
re-running a complete analysis; drop any fix that doesn't work and try
another one. The fix must not add build warnings and must pass the
checkpatch.pl checks (see submitting-patches.rst).
-6. Commit the working fix with a detailed message describing the problem, the
- solution and a Fixes tag. Do not add a Signed-off-by tag.
+6. Commit the working fix with a detailed message describing the problem, its
+ user-visible impact (see "Describe your changes" in
+ Documentation/process/submitting-patches.rst), the solution and a Fixes
+ tag. Do not add a Signed-off-by tag.
7. Identify the maintainers and lists using scripts/get_maintainer.pl.
Documentation/process/security-bugs.rst shows how to do that.
8. Indicate what could not be done. If the fix could not be built or tested, or
diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
index 9cd19a71e96ec..52cccb08ce896 100644
--- a/Documentation/process/submitting-patches.rst
+++ b/Documentation/process/submitting-patches.rst
@@ -51,6 +51,8 @@ motivated you to do this work. Convince the reviewer that there is a
problem worth fixing and that it makes sense for them to read past the
first paragraph.
+.. _user_visible_impact:
+
Describe user-visible impact. Straight up crashes and lockups are
pretty convincing, but not all bugs are that blatant. Even if the
problem was spotted during code review, describe the impact you think
@@ -61,6 +63,15 @@ from upstream, so include anything that could help route your change
downstream: provoking circumstances, excerpts from dmesg, crash
descriptions, performance regressions, latency spikes, lockups, etc.
+For a bug fix, this means saying what the bug does to a running system:
+the worst that a user can see, and what it takes to trigger it. An
+account of what the code does wrong is not a substitute, as it leaves
+every reader to work the consequences out again. If the bug was found
+by review or by a tool and has never been seen to happen, say so. If
+it has no effect that a user could notice, say that too. Maintainers
+and the people looking after stable trees decide from this whether the
+fix needs to be backported.
+
Quantify optimizations and trade-offs. If you claim improvements in
performance, memory consumption, stack footprint, or binary size,
include numbers that back them up. But also describe non-obvious
base-commit: 2138148bf44fd84d3e0a863f0e8cb3627cdcc606
--
2.53.0
^ permalink raw reply related [flat|nested] 5+ messages in thread* Re: [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact
2026-11-16 19:14 [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact Sasha Levin
@ 2026-11-16 19:34 ` Andrew Morton
2026-11-16 19:49 ` Willy Tarreau
2026-11-16 19:52 ` Sasha Levin
2026-11-16 19:47 ` Willy Tarreau
1 sibling, 2 replies; 5+ messages in thread
From: Andrew Morton @ 2026-11-16 19:34 UTC (permalink / raw)
To: Sasha Levin
Cc: Jonathan Corbet, Shuah Khan, Randy Dunlap, Greg Kroah-Hartman,
Theodore Ts'o, Willy Tarreau, workflows, linux-doc,
linux-kernel, David Hildenbrand
On Mon, 16 Nov 2026 14:14:36 -0500 Sasha Levin <sashal@kernel.org> wrote:
> "Describe your changes" already asks for the user-visible impact of a
> change, but changelogs for fixes still tend to say what the code does,
> why that's wrong and what the patch changes, and stop there. Whoever
> has to decide if the fix needs backporting is left to work out what
> the bug does to a running system.
>
> Say what that means for a bug fix: describe the worst a user can see
> and what it takes to trigger it, say so if the bug was never seen to
> happen, and say so if it has no visible effect at all. Give the
> paragraph a label so people can be pointed at it.
>
> Coding assistants are told to commit a fix with a message that
> describes the problem and the solution. Add the user-visible impact to
> that list and point them at the section.
Thanks. Hopefully this will reduce my outbound nagmails.
Acked-by: Andrew Morton <akpm@linux-foundation.org>
> +For a bug fix, this means saying what the bug does to a running system:
> +the worst that a user can see, and what it takes to trigger it. An
> +account of what the code does wrong is not a substitute, as it leaves
> +every reader to work the consequences out again. If the bug was found
> +by review or by a tool and has never been seen to happen, say so. If
> +it has no effect that a user could notice, say that too. Maintainers
> +and the people looking after stable trees decide from this whether the
> +fix needs to be backported.
However, I fear that in these times this isn't strong enough.
The question used to be "will this bug impact real-world people doing
real-world things".
That's an insufficient question to be asking now. An additional
question is "can this bug permit a sufficiently motivated, well funded
and LLM-using Bad Actor to cause problems".
Real-world people's real-world workloads don't use an LLM-written
exploit to set 16 CPUs hammering away at an LLM-detected kernel race
for an hour.
So those fantastically-hard-to-hit bugs have become things which we
(and those whom we serve) care about more than we used to.
Maybe this doc addresses that elsewhere, tl;dr ;)
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact
2026-11-16 19:34 ` Andrew Morton
@ 2026-11-16 19:49 ` Willy Tarreau
2026-11-16 19:52 ` Sasha Levin
1 sibling, 0 replies; 5+ messages in thread
From: Willy Tarreau @ 2026-11-16 19:49 UTC (permalink / raw)
To: Andrew Morton
Cc: Sasha Levin, Jonathan Corbet, Shuah Khan, Randy Dunlap,
Greg Kroah-Hartman, Theodore Ts'o, workflows, linux-doc,
linux-kernel, David Hildenbrand
On Mon, Nov 16, 2026 at 11:34:53AM -0800, Andrew Morton wrote:
> On Mon, 16 Nov 2026 14:14:36 -0500 Sasha Levin <sashal@kernel.org> wrote:
>
> > "Describe your changes" already asks for the user-visible impact of a
> > change, but changelogs for fixes still tend to say what the code does,
> > why that's wrong and what the patch changes, and stop there. Whoever
> > has to decide if the fix needs backporting is left to work out what
> > the bug does to a running system.
> >
> > Say what that means for a bug fix: describe the worst a user can see
> > and what it takes to trigger it, say so if the bug was never seen to
> > happen, and say so if it has no visible effect at all. Give the
> > paragraph a label so people can be pointed at it.
> >
> > Coding assistants are told to commit a fix with a message that
> > describes the problem and the solution. Add the user-visible impact to
> > that list and point them at the section.
>
> Thanks. Hopefully this will reduce my outbound nagmails.
>
> Acked-by: Andrew Morton <akpm@linux-foundation.org>
>
> > +For a bug fix, this means saying what the bug does to a running system:
> > +the worst that a user can see, and what it takes to trigger it. An
> > +account of what the code does wrong is not a substitute, as it leaves
> > +every reader to work the consequences out again. If the bug was found
> > +by review or by a tool and has never been seen to happen, say so. If
> > +it has no effect that a user could notice, say that too. Maintainers
> > +and the people looking after stable trees decide from this whether the
> > +fix needs to be backported.
>
> However, I fear that in these times this isn't strong enough.
>
> The question used to be "will this bug impact real-world people doing
> real-world things".
>
> That's an insufficient question to be asking now. An additional
> question is "can this bug permit a sufficiently motivated, well funded
> and LLM-using Bad Actor to cause problems".
>
> Real-world people's real-world workloads don't use an LLM-written
> exploit to set 16 CPUs hammering away at an LLM-detected kernel race
> for an hour.
>
> So those fantastically-hard-to-hit bugs have become things which we
> (and those whom we serve) care about more than we used to.
Agreed but there's a difference in who makes the effort. When it's the
attacker, it does count. When it requires the user to be complice (as
is frequently the case, typically in security reports), it's no longer
the same as what matters is that users who did nothing to shoot
themselves in the foot stay safe. Those who shoot, well...
> Maybe this doc addresses that elsewhere, tl;dr ;)
Willy
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact
2026-11-16 19:34 ` Andrew Morton
2026-11-16 19:49 ` Willy Tarreau
@ 2026-11-16 19:52 ` Sasha Levin
1 sibling, 0 replies; 5+ messages in thread
From: Sasha Levin @ 2026-11-16 19:52 UTC (permalink / raw)
To: Andrew Morton
Cc: Sasha Levin, Willy Tarreau, Jonathan Corbet, Shuah Khan,
Randy Dunlap, Greg Kroah-Hartman, Theodore Ts'o,
David Hildenbrand, workflows, linux-doc, linux-kernel
On Mon, Nov 16, 2026 at 11:34:53AM -0800, Andrew Morton wrote:
>However, I fear that in these times this isn't strong enough.
>
>The question used to be "will this bug impact real-world people doing
>real-world things".
>
>That's an insufficient question to be asking now. An additional
>question is "can this bug permit a sufficiently motivated, well funded
>and LLM-using Bad Actor to cause problems".
[...]
>Maybe this doc addresses that elsewhere, tl;dr ;)
It doesn't. The closest thing is the "send exploitable bugs to security@"
paragraph further down, and that assumes you already know it's
exploitable.
Willy pointed out the other side of this: ask an LLM for the worst case
and it'll stack up every config option, module and USB emulator needed
to get there, while for backports you also want to know whether
innocent users are affected at all.
I think both fit if we ask about the two cases separately. Something
like this on top?
diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
--- a/Documentation/process/submitting-patches.rst
+++ b/Documentation/process/submitting-patches.rst
@@ -63,14 +63,26 @@ from upstream, so include anything that could help route your change
downstream: provoking circumstances, excerpts from dmesg, crash
descriptions, performance regressions, latency spikes, lockups, etc.
-For a bug fix, this means saying what the bug does to a running system:
-the worst that a user can see, and what it takes to trigger it. An
-account of what the code does wrong is not a substitute, as it leaves
-every reader to work the consequences out again. If the bug was found
-by review or by a tool and has never been seen to happen, say so. If
-it has no effect that a user could notice, say that too. Maintainers
-and the people looking after stable trees decide from this whether the
-fix needs to be backported.
+For a bug fix, this means saying what the bug does to a running system.
+An account of what the code does wrong is not a substitute, as it leaves
+every reader to work the consequences out again. Cover two cases:
+
+- Users who are not looking for the bug. Say what a normal workload is
+ likely to run into, and separately what the worst case is and what it
+ takes to get there: configuration, hardware, privileges, timing. If
+ the bug was found by review or by a tool and has never been seen to
+ happen, say so. If it has no effect that a user could notice, say
+ that too.
+
+- Someone triggering the bug on purpose. Say whether an unprivileged
+ user could do it and what that would take. A race that no normal
+ workload loses can still be won by a program that retries it on every
+ CPU for an hour. If that makes the bug a vulnerability under
+ Documentation/process/threat-model.rst, follow
+ Documentation/process/security-bugs.rst.
+
+Maintainers and the people looking after stable trees decide from this
+whether the fix needs to be backported.
Quantify optimizations and trade-offs. If you claim improvements in
performance, memory consumption, stack footprint, or binary size,
If that works for both of you I'll fold it into a v2.
--
Thanks,
Sasha
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact
2026-11-16 19:14 [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact Sasha Levin
2026-11-16 19:34 ` Andrew Morton
@ 2026-11-16 19:47 ` Willy Tarreau
1 sibling, 0 replies; 5+ messages in thread
From: Willy Tarreau @ 2026-11-16 19:47 UTC (permalink / raw)
To: Sasha Levin
Cc: Jonathan Corbet, Andrew Morton, Shuah Khan, Randy Dunlap,
Greg Kroah-Hartman, Theodore Ts'o, workflows, linux-doc,
linux-kernel
Hi Sasha,
On Mon, Nov 16, 2026 at 02:14:36PM -0500, Sasha Levin wrote:
> "Describe your changes" already asks for the user-visible impact of a
> change, but changelogs for fixes still tend to say what the code does,
> why that's wrong and what the patch changes, and stop there. Whoever
> has to decide if the fix needs backporting is left to work out what
> the bug does to a running system.
>
> Say what that means for a bug fix: describe the worst a user can see
> and what it takes to trigger it, say so if the bug was never seen to
> happen, and say so if it has no visible effect at all. Give the
> paragraph a label so people can be pointed at it.
>
> Coding assistants are told to commit a fix with a message that
> describes the problem and the solution. Add the user-visible impact to
> that list and point them at the section.
>
> Suggested-by: Andrew Morton <akpm@linux-foundation.org>
> Link: https://lore.kernel.org/r/20261111171055.527b4bf3da705367bc78a64c@linux-foundation.org
> Signed-off-by: Sasha Levin <sashal@kernel.org>
> ---
> Documentation/process/coding-assistants.rst | 6 ++++--
> Documentation/process/submitting-patches.rst | 11 +++++++++++
> 2 files changed, 15 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/process/coding-assistants.rst b/Documentation/process/coding-assistants.rst
> index 509dbf23a099b..ef01ce8d0ff91 100644
> --- a/Documentation/process/coding-assistants.rst
> +++ b/Documentation/process/coding-assistants.rst
> @@ -63,8 +63,10 @@ these steps:
> re-running a complete analysis; drop any fix that doesn't work and try
> another one. The fix must not add build warnings and must pass the
> checkpatch.pl checks (see submitting-patches.rst).
> -6. Commit the working fix with a detailed message describing the problem, the
> - solution and a Fixes tag. Do not add a Signed-off-by tag.
> +6. Commit the working fix with a detailed message describing the problem, its
> + user-visible impact (see "Describe your changes" in
> + Documentation/process/submitting-patches.rst), the solution and a Fixes
> + tag. Do not add a Signed-off-by tag.
> 7. Identify the maintainers and lists using scripts/get_maintainer.pl.
> Documentation/process/security-bugs.rst shows how to do that.
> 8. Indicate what could not be done. If the fix could not be built or tested, or
> diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
> index 9cd19a71e96ec..52cccb08ce896 100644
> --- a/Documentation/process/submitting-patches.rst
> +++ b/Documentation/process/submitting-patches.rst
> @@ -51,6 +51,8 @@ motivated you to do this work. Convince the reviewer that there is a
> problem worth fixing and that it makes sense for them to read past the
> first paragraph.
>
> +.. _user_visible_impact:
> +
> Describe user-visible impact. Straight up crashes and lockups are
> pretty convincing, but not all bugs are that blatant. Even if the
> problem was spotted during code review, describe the impact you think
> @@ -61,6 +63,15 @@ from upstream, so include anything that could help route your change
> downstream: provoking circumstances, excerpts from dmesg, crash
> descriptions, performance regressions, latency spikes, lockups, etc.
>
> +For a bug fix, this means saying what the bug does to a running system:
> +the worst that a user can see, and what it takes to trigger it. An
> +account of what the code does wrong is not a substitute, as it leaves
> +every reader to work the consequences out again. If the bug was found
> +by review or by a tool and has never been seen to happen, say so. If
> +it has no effect that a user could notice, say that too. Maintainers
> +and the people looking after stable trees decide from this whether the
> +fix needs to be backported.
> +
Look good.
Reviewed-by: Willy Tarreau <w@1wt.eu>
I think we can go even further by distinguishing the absolute worst
that can happen from the most likely. When you ask an LLM analyzing
code about a worst case, it doesn't care much about the real world
and will often explain that if the user enable CONFIG_xxx and write
foo under /proc/something and has force-loaded some outdated modules
and has plugged a device emulator into their USB port, then the bug
could indeed get worse. For backports you also want to know whether
innocent users are affected or not.
> Quantify optimizations and trade-offs. If you claim improvements in
> performance, memory consumption, stack footprint, or binary size,
> include numbers that back them up. But also describe non-obvious
>
> base-commit: 2138148bf44fd84d3e0a863f0e8cb3627cdcc606
> --
> 2.53.0
Cheers,
Willy
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2026-11-16 19:52 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-11-16 19:14 [PATCH] docs: submitting-patches: ask bug fixes for their user-visible impact Sasha Levin
2026-11-16 19:34 ` Andrew Morton
2026-11-16 19:49 ` Willy Tarreau
2026-11-16 19:52 ` Sasha Levin
2026-11-16 19:47 ` Willy Tarreau
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox