[PATCH, v3] wwwdocs: e-mail subject lines for contributions

[Nathan Sidwell]

On 2/3/20 6:41 AM, Richard Earnshaw (lists) wrote:
> On 22/01/2020 17:45, Richard Earnshaw (lists) wrote:
>>
>> [updated based on v2 discussions]
>>
>> This patch proposes some new (additional) rules for email subject lines
>> when contributing to GCC.  The goal is to make sure that, as far as
>> possible, the subject for a patch will form a good summary when the
>> message is committed to the repository if applied with 'git am'.  Where
>> possible, I've tried to align these rules with those already in
>> use for glibc, so that the differences are minimal and only where
>> necessary.
>>
>> Some things that differ from existing practice (at least by some people)
>> are:
>>
>> - Use '<topic>:' rather than '[<topic>]'
>> Â Â  - This is more git friendly and works with 'git am'.
>> - Put bug numbers at the end of the line rather than the beginning.
>> Â Â  - The bug number is useful, but not as useful as the brief summary.
>> Â Â Â Â  Also, use the shortened form, as the topic part is more usefully
>> Â Â Â Â  conveyed in the proper topic field (see above).
> 
> I've not seen any follow-up to this version.  Should we go ahead and 
> adopt this?

do it!

do it! do it! do it!

nathan
-- 
Nathan Sidwell