public inbox for linux-kernel@vger.kernel.org
 help / color / mirror / Atom feed
From: Rob Landley <rob@landley.net>
To: Subodh Nijsure <snijsure@grid-net.com>
Cc: rdunlap@xenotime.net, linux-doc@vger.kernel.org,
	linux-kernel@vger.kernel.org, linux@arm.linux.org.uk
Subject: Re: [PATCH] Recommend correct way to submit new version of the patches.
Date: Thu, 26 Apr 2012 22:39:25 -0500	[thread overview]
Message-ID: <4F9A14ED.1000804@landley.net> (raw)
In-Reply-To: <4F998DA1.8040004@grid-net.com>

On 04/26/2012 01:02 PM, Subodh Nijsure wrote:
...
>> Would you like me to take a stab at wordsmithing this? Something like:
>>
>>    Each patch series should ideally start with a 0/X summary message
>>    explaining the purpose of the series, with each Y/X message posted as
>>    a reply to that summary.
>>
>>    Post each new version of a patch series as its own thread. This avoids
>>    unmanageably long threads and burying new activity in old threads
>>    where it's less likely to be noticed. To reference a previous series,
>>    give a URL to a web archive, or provide the message ID, or the
>>    subject line and date of the previous posting.
>>
>> (The existing context doesn't even mention 0/5 summary messages, and the
>> hunk about "When you submit or resubmit" is up at line 101 rather than
>> down in the 580's...)
> I struggled with putting those two paragraph up at line 101 or in
> section that describes canonical patch format, decided on the later.

Maybe the file will someday need structural cleanup so there's one
obvious place to put this, but that's beyond the scope of this patch.

> Never been good at word-smithing.
> I have struggled with how does one submit patch reversions and Russell
> King described it very well on arm-linux mailing list and I thought we
> should capture this in documentation to help others that are just
> getting started with the process. Do you want me to submit v2 or you
> have it?

Did my rephrase capture what you wanted to say?

Rob
-- 
GNU/Linux isn't: Linux=GPLv2, GNU=GPLv3+, they can't share code.
Either it's "mere aggregation", or a license violation.  Pick one.

      reply	other threads:[~2012-04-27  3:39 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2012-04-25 21:51 [PATCH] Recommend correct way to submit new version of the patches Subodh Nijsure
2012-04-26 16:43 ` Rob Landley
2012-04-26 18:02   ` Subodh Nijsure
2012-04-27  3:39     ` Rob Landley [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=4F9A14ED.1000804@landley.net \
    --to=rob@landley.net \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux@arm.linux.org.uk \
    --cc=rdunlap@xenotime.net \
    --cc=snijsure@grid-net.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox