From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 70E14C77B7C for ; Wed, 10 May 2023 23:07:53 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229461AbjEJXHw (ORCPT ); Wed, 10 May 2023 19:07:52 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37366 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229826AbjEJXHv (ORCPT ); Wed, 10 May 2023 19:07:51 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [IPv6:2604:1380:4641:c500::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DDCE3102; Wed, 10 May 2023 16:07:48 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id 75B98635F4; Wed, 10 May 2023 23:07:48 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id F3AA4C433D2; Wed, 10 May 2023 23:07:46 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linuxfoundation.org; s=korg; t=1683760067; bh=fgE25D1hp4IWtAFkK0USGG1ZKqXkY7wUpEJmfwsr3t8=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=DN+agf4q5MwKo4DomiNNQD1lQZveu+mTwkOk1NlmTwFSaiKklJNp88Ex+ZvwcwNUp TjcQRudm8pl9/bfmKneMPzrDktLsnrkjGkaFV3ofILXTs+cnY7A2cMulTzzQZPumM6 Wvu6aJc1eCIgJ4gXPhW/UqfPoSdKSs1C+i/w8clI= Date: Thu, 11 May 2023 08:07:42 +0900 From: Greg Kroah-Hartman To: Kees Cook Cc: Jonathan Corbet , Thorsten Leemhuis , Rong Tao , Lukas Bulwahn , Zhangfei Gao , linux-doc@vger.kernel.org, linux-hardening@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] docs: submitting-patches: Discuss interleaved replies Message-ID: <2023051132-erratic-reshoot-0cb5@gregkh> References: <20230510183423.never.877-kees@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20230510183423.never.877-kees@kernel.org> Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Wed, May 10, 2023 at 11:34:26AM -0700, Kees Cook wrote: > Top-posting has been strongly discouraged in Linux development, but this > was actually not written anywhere in the common documentation about > sending patches and replying to reviews. Add a section about trimming > and interleaved replies. > > Cc: Jonathan Corbet > Cc: Greg Kroah-Hartman > Cc: Thorsten Leemhuis > Cc: Rong Tao > Cc: Lukas Bulwahn > Cc: Zhangfei Gao > Cc: linux-doc@vger.kernel.org > Cc: linux-hardening@vger.kernel.org > Signed-off-by: Kees Cook > --- > Documentation/process/submitting-patches.rst | 23 ++++++++++++++++++++ > 1 file changed, 23 insertions(+) > > diff --git a/Documentation/process/submitting-patches.rst b/Documentation/process/submitting-patches.rst > index eac7167dce83..3e838da8822f 100644 > --- a/Documentation/process/submitting-patches.rst > +++ b/Documentation/process/submitting-patches.rst > @@ -326,6 +326,29 @@ explaining difference aganst previous submission (see > See Documentation/process/email-clients.rst for recommendations on email > clients and mailing list etiquette. > > +Use trimmed interleaved replies in email discussions > +---------------------------------------------------- > +Top-posting is strongly discouraged in Linux kernel development > +discusions. Interleaved (or "inline") replies make conversations much > +easier to follow. For more details see: > +https://en.wikipedia.org/wiki/Posting_style#Interleaved_style > + > +As is frequently quoted on the mailing list: > + > + A: http://en.wikipedia.org/wiki/Top_post > + Q: Were do I find info about this thing called top-posting? > + A: Because it messes up the order in which people normally read text. > + Q: Why is top-posting such a bad thing? > + A: Top-posting. > + Q: What is the most annoying thing in e-mail? > + > +Similarly, please trim all unneeded quotations that aren't relevant > +to your reply. This makes replies easier to find, and saves time and > +space. For more details see: http://daringfireball.net/2007/07/on_top > + > + A: No. > + Q: Should I include quotations after my reply? > + > .. _resend_reminders: > > Don't get discouraged - or impatient > -- > 2.34.1 > Yes!!! Acked-by: Greg Kroah-Hartman