Re: [PATCH v1] doc: update guideline for fix commit messages

[Ferruh Yigit <ferruh.yigit@amd.com>]

On 1/25/2024 3:39 AM, Sivaramakrishnan Venkat wrote:
> Maintainers remove the Cc author line when merging the patch.
> So, the guidelines is updated with a suggestion for the placement
> of Cc lines in a commit message for easy merging.
> 
> Signed-off-by: Sivaramakrishnan Venkat <venkatx.sivaramakrishnan@intel.com>
> ---
>  doc/guides/contributing/patches.rst | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/doc/guides/contributing/patches.rst b/doc/guides/contributing/patches.rst
> index e286d9e6d5..e109365599 100644
> --- a/doc/guides/contributing/patches.rst
> +++ b/doc/guides/contributing/patches.rst
> @@ -275,6 +275,12 @@ Here are some guidelines for the body of a commit message:
>  
>       Signed-off-by: Alex Smith <alex.smith@example.com>
>  
> +* .. Note::
> +
> +     Maintainers remove the "Cc: author@example.com" line when merging the patch.
> +     To help the maintainer, the submitter may move this line to the notes section
> +     of the commit, after the ``---`` separator.
> +
>  * When fixing an error or warning it is useful to add the error message and instructions on how to reproduce it.
>  
>  * Use correct capitalization, punctuation and spelling.

Thanks Sivaramakrishnan for the doc update, that is practically what
happens,
but "Note" is to get additional attention, and there are already
multiple steps involved to prepare a commit log and this one is not
really that important, so lets not complicate it more for new contributors.

One option is add above information without ".. Note::" block, and
shorten it a little more, with adding the reasoning of adding "Cc:
author@example.com" (so I am asking adding more info and make paragraph
shorter :)

Other option is update samples to the desired format, it won't explain
the ask but imply it by showing requested output, as we are doing for
"Depends-on" tag.


I am for starting with the second option first, update samples, and see
if it improves things, what do you think?