summaryrefslogtreecommitdiffstats
path: root/Documentation/process
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2020-09-03 12:05:43 -0400
committerJonathan Corbet <corbet@lwn.net>2020-09-03 15:39:01 -0600
commit7433ff33e8baa5ceafae3d99d639d5ace2458798 (patch)
tree439f61b8ead46591e27bfe8bf4e71cb76edb7872 /Documentation/process
parentef227c39b6f70d9ad83f6bda1914070211f8795b (diff)
downloadlinux-stable-7433ff33e8baa5ceafae3d99d639d5ace2458798.tar.gz
linux-stable-7433ff33e8baa5ceafae3d99d639d5ace2458798.tar.bz2
linux-stable-7433ff33e8baa5ceafae3d99d639d5ace2458798.zip
Documentation/process: expand plain-text advice
This adds a link to https://useplaintext.email to email-clients.rst, which is a more exhaustive resource on configuring various mail clients for plain text use. submitting-patches.rst is also updated to direct readers to email-clients.rst to equip new contributors with the requisite knowledge to become a good participant on the mailing lists. Signed-off-by: Drew DeVault <sir@cmpwn.com> Reviewed-by: Randy Dunlap <rdunlap@infradead.org> Link: https://lore.kernel.org/r/20200903160545.83185-3-sir@cmpwn.com Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Diffstat (limited to 'Documentation/process')
-rw-r--r--Documentation/process/email-clients.rst5
-rw-r--r--Documentation/process/submitting-patches.rst3
2 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/process/email-clients.rst b/Documentation/process/email-clients.rst
index c9e4ce2613c0..16586f6cc888 100644
--- a/Documentation/process/email-clients.rst
+++ b/Documentation/process/email-clients.rst
@@ -25,6 +25,11 @@ attachments, but then the attachments should have content-type
it makes quoting portions of the patch more difficult in the patch
review process.
+It's also strongly recommended that you use plain text in your email body,
+for patches and other emails alike. https://useplaintext.email may be useful
+for information on how to configure your preferred email client, as well as
+listing recommended email clients should you not already have a preference.
+
Email clients that are used for Linux kernel patches should send the
patch text untouched. For example, they should not modify or delete tabs
or spaces, even at the beginning or end of lines.
diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst
index ad25585a518a..9387d2eead23 100644
--- a/Documentation/process/submitting-patches.rst
+++ b/Documentation/process/submitting-patches.rst
@@ -396,6 +396,9 @@ for their time. Code review is a tiring and time-consuming process, and
reviewers sometimes get grumpy. Even in that case, though, respond
politely and address the problems they have pointed out.
+See :ref:`Documentation/process/email-clients.rst` for recommendations on email
+clients and mailing list etiquette.
+
Don't get discouraged - or impatient
------------------------------------