docs: submitting-patches: encourage direct notifications to commenters
authorThomas Weißschuh <linux@weissschuh.net>
Tue, 3 Oct 2023 06:30:03 +0000 (08:30 +0200)
committerJonathan Corbet <corbet@lwn.net>
Tue, 10 Oct 2023 19:58:54 +0000 (13:58 -0600)
Commenters may not receive new versions of patches via the lists.
Without a directed notification to them they might miss those new
versions.

This is frustrating for the patch developers as they don't receive their
earned Reviewed-by.
It is also frustrating for the commenters, as they might think their
review got ignored or they have to dig up new versions from the archive
manually.

So encourage patch submitters to make sure that all commenters get
notified also when no Reviewed-by was issued yet.

Signed-off-by: Thomas Weißschuh <linux@weissschuh.net>
Reviewed-by: Christoph Hellwig <hch@lst.de>
Acked-by: Alexander Dahl <ada@thorsis.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Link: https://lore.kernel.org/r/20231003-docs-cc-reviewer-v2-1-f93fb946e21e@weissschuh.net
Documentation/process/submitting-patches.rst

index 3fcfa029c9b302caeba3c2ea51835dfed2a7499a..86d346bcb8ef0fee5a494c4b532de751c01126b7 100644 (file)
@@ -327,6 +327,8 @@ politely and address the problems they have pointed out.  When sending a next
 version, add a ``patch changelog`` to the cover letter or to individual patches
 explaining difference against previous submission (see
 :ref:`the_canonical_patch_format`).
+Notify people that commented on your patch about new versions by adding them to
+the patches CC list.
 
 See Documentation/process/email-clients.rst for recommendations on email
 clients and mailing list etiquette.