[PATCH v3] docs: submitting-patches: Clarify partial review tags
From: Krzysztof Kozlowski
Date: Tue Nov 10 2026 - 09:44:31 EST
Refactoring of driver subsystems or some core driver parts often come
with change of the actual drivers. If that happens within one patch,
people giving "Reviewed-by" tag only to piece of the patch, like one
driver, and ignoring the rest including the main concept of the patch,
are not really reviewing "the patch".
As explained in the Submitting Patches document, the "Reviewer's
statement of oversight" is for patch as in "entire patch" meaning:
(a) I have carried out a technical review of this patch to
evaluate its appropriateness and readiness for inclusion into
the mainline kernel.
The sentence is explicit, exhaustive and complete, meaning it does not
allow implicit variations like: "this patch or part of this patch".
Reviewing pieces of the patch while ignoring the main part of it, is
much closer to Acknowledgment, thus Ack or at least "Reviewed-by" should
be followed by '# subpart' suffix.
Reviewed-by: Andy Shevchenko <andriy.shevchenko@xxxxxxxxxxxxxxx>
Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@xxxxxxxxxxxxxxxx>
---
Changes in v3:
1. Minor commit msg adjustments
2. Use Driver X author <foo@xxxxxxxxxxx> # for Driver
3. Tag
Changes in v2:
1. Few grammar fixes in text and commit msg.
2. Mention the "# subpart-name" marker solution.
Cc: Wolfram Sang <wsa+renesas@xxxxxxxxxxxxxxxxxxxx>
Cc: Andy Shevchenko <andriy.shevchenko@xxxxxxxxxxxxxxx>
---
Documentation/process/submitting-patches.rst | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
index f271d7413f72..040f81b2bedf 100644
--- a/Documentation/process/submitting-patches.rst
+++ b/Documentation/process/submitting-patches.rst
@@ -585,6 +585,11 @@ serves to give credit to reviewers and to inform maintainers of the degree of
review which has been done on the patch. Reviewed-by: tags, when supplied by
reviewers known to understand the subject area and to perform thorough reviews,
will normally increase the likelihood of your patch getting into the kernel.
+If the reviewer checks only a piece of the patch, leaving the rest unreviewed,
+especially skipping the main concept of the patch, then more appropriate is
+an Acked-by tag or adding a "# subpart-name" marker after the Reviewed-by tag:
+
+ Reviewed-by: Driver X Reviewer <foo@xxxxxxxxxxx> # for Driver
Both Tested-by and Reviewed-by tags, once received on mailing list from tester
or reviewer, should be added by author to the applicable patches when sending
--
2.53.0