Re: ChangeLog and commit messages

[Sean Whitton]

Hello,

On Mon 19 Jun 2023 at 07:33PM +03, Eli Zaretskii wrote:

> If your problems are with the feature branch, then I think you are
> making your life harder than it needs to be.  Our conventions for
> formatting commit log messages don't apply to feature branches.  On
> feature branches, the developers are free to format the log messages
> as they see fit; the only log message that matters is the one for the
> merge-commit which lands the feature branch on master (which you have
> to create by hand anyway).
>
> The upshot of all this is that while you are working on a feature
> branch:
>
>   . you can use short single-line note-like log messages, which might
>     be unclear to anyone but yourself
>   . you should generally commit each time when you finish some
>     meaningful changeset, so that it could be later reverted without
>     complications -- this goes well with short log messages
>   . it is futile to use "C-x 4 a"-style log messages, especially for
>     changes in files or in functions the branch adds, because in the
>     final commit log we only need to see "foo: New file"

Is this written down somewhere?  I had no idea about it.  If I'd
recently started a feature branch, I'd likely have been carefully
formatting my commits, for no good reason.

-- 
Sean Whitton