Re: [PATCH 5/5] RelNotes: wordsmithing

From: Junio C Hamano <gitster@pobox.com>
Date: Apr 23, 2015, 15:38 UTC
Message-ID: <xmqq618mdfdh.fsf@gitster.dls.corp.google.com>
In-Reply-To: <5538E9F3.7040702@alum.mit.edu>

Michael Haggerty <mhagger@alum.mit.edu> writes:

Show 18 quoted lines

> On 04/23/2015 02:27 PM, Michael Haggerty wrote:
>> Make many textual tweaks to the 2.4.0 release notes.
>> 
>> Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu>
>> ---
>>  Documentation/RelNotes/2.4.0.txt | 336 ++++++++++++++++++++-------------------
>>  1 file changed, 172 insertions(+), 164 deletions(-)
>> 
>> diff --git a/Documentation/RelNotes/2.4.0.txt b/Documentation/RelNotes/2.4.0.txt
>> index 7b23ca3..cde64be 100644
>> --- a/Documentation/RelNotes/2.4.0.txt
>> +++ b/Documentation/RelNotes/2.4.0.txt
>> [...]
>
> Oh, I just noticed that many of the same blurbs appear in the release
> notes for the maintenance versions. Once there is agreement on how many
> of the changes to accept, the analogous changes should probably be made
> in those other files.

Thanks.

FYI, these days the same text appears in

 (1) the topic description in "What's cooking";
 (2) the merge commit for the topic when it is merged to 'next';
 (3) the merge commit for the topic when it is merged to 'master';
 (4) Release notes for the 'master' and 'maint', when it is merged.

So the best time to catch mistakes and to rephrase it is when you see something questionable in "What's cooking", ideally before it hits 'next', before it hits 'master'.