>>>>> On Sun, 24 Jan 2016, Michael Orlitzky wrote:

> The ChangeLog page is nonsense as-is, and removing it makes the
> devmanual better. Afterwards, if someone wants to take the commit
> message guidelines from the wiki and merge them with the old ChangeLog
> tips, great. There's only two things worth salvaging from the ChangeLog
> page. Here's the combined list:

>   1. Everything from the Git workflow wiki page "Commit message format"
>      section.

I would say not only that section, but most of the page. The devmanual
is the one central place where our development workflow should be
documented, not some random wiki page.

>   2. Mention the "Gentoo-Bug:" identifier.

Right. (But had we settled for "Gentoo-Bug:"? IIRC, last time this was
discussed there was no consensus.)

>      Using "bug #12345" in the commit message itself causes trouble.
>      If you word-wrap on the "#12345", it will silently clobber the
>      message.

That's one of the reasons why I have 'commentchar = ";"' in my
.gitconfig file. (Not sure if that option would be worth mentioning
in our documentation, though.)

> [...]

Ulrich

Attachment: pgpCIOxORuqZQ.pgp
Description: PGP signature

Reply via email to