From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 14 Apr 2016 22:16:59 GMT
Subject: Re: [PATCH 1/2] Partition SubmittingPatches doc into two files
Message-ID: <xmqq7ffzg7j8.fsf@gitster.mtv.corp.google.com>
In-Reply-To: <0102015416d52ae9-da060607-a742-4efc-8b40-98301c2bb261-000000@eu-west-1.amazonses.com>

Roberto Tyley <roberto.tyley@gmail.com> writes:

> Subject: Re: [PATCH 1/2] Partition SubmittingPatches doc into two files

That violates the first paragraph of "(2) Describe your changes
well."

	SubmittingPatches: separate parts specific to mailed-in	patches

or something like that, to

 - Prefix with the "area";
 - Summarize what you did in a way that makes it clear why.

> No editorial changes in this commit, the text that is transferred into the
> second file is unchanged apart from minor chunk re-ordering.
>
> The split is based on:
>
> * Information needed for all users, whether using `git send-email` or
>   submitGit (ie good commit practice, mailing list etiquette)
> * Information needed just for `git send-email`/MUA users (generating the
>   right kind of diff, avoid MIME & PGP, send-email & MUA specific hints)
> ---

Violates "(5) Sign your work"?