-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA512 Ulrich Mueller: >>>>>> 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. > If the most up-to-date information is on the wiki, constantly updating devmanual to match the wiki creates unnecessary maintenance burden.
>> 2. Mention the "Gentoo-Bug:" identifier. > > Right. (But had we settled for "Gentoo-Bug:"? IIRC, last time this > was discussed there was no consensus.) > Related to my point above, looks like the git workflow is still in the process of making. I expect that some discussion will continue to take place in the future. We can always fix the other parts of the devmanual and come back to this. Is it possible to merge this changeset as is while the workflow matures, or should I go for a round 3? >> 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 > - -- gokturk -----BEGIN PGP SIGNATURE----- iQEcBAEBCgAGBQJWqEU2AAoJEIT4AuXAiM4zwCAH/3q8FQB+zX0q1kuXjJfYnF3j IvJ2uKjuHMfbSAoGy2bUGEEhsvXGpNTmLv7vDIiHILCeLR0mD1eAmWHuJjjUSmJx PyK6kAPaXX++E5aZ9gRuXqNFSGqiNx3oPvzQs0SH6vXgVec8fpmRk6y/Dg2r20Am hfJLPIeD8Z9Vf/0wM7EcjiS3eVYrTnYCX+aGAKpgk74zKHcnHTL9S77no0Lemby1 vlCK9ceouVd6OYdDcvjNg73umlci7JIenCZCU3nagloGwvH6XDFWdGkWSRLQ0G7T DoZlysM2Litafjr7NgyQ7R8xp1HnR+tmWfY26urIPd4rKU+aA05kPnQiTjgKTHo= =UDYD -----END PGP SIGNATURE-----
