[webkit-dev] Changes to prepare-ChangeLog

Maciej Stachowiak mjs at apple.com
Thu Jul 9 01:32:19 PDT 2009


Now that my attention has been called to it, it's starting to bug me  
that everyone formats their ChangeLog entries slightly differently.  
How about this as the canonical format (with prepare-ChangeLog  
encouraging it)?

2009-07-08  Maciej Stachowiak  <mjs at apple.com>

         Make prepare-ChangeLog less shouty
         https://bugs.webkit.org/show_bug.cgi?id=27098

         Reviewed by Mark Rowe.

         * Scripts/prepare-ChangeLog:



So specifically:

- Reviewed by line would go below, not above, to make git users happy  
(well, happi*er*)
- Bug URL remains below one-line description, for git joy and  
scannability
- No angle brackets around URL, so that you can cut/paste or drag it  
from a URL field without extra work
- No line between URL and summary

Is that a format everyone can live with for ChangeLogs and commit  
messages? If so, I'll post a patch to update prepare-ChangeLog  
accordingly.

Regards,
Maciej



More information about the webkit-dev mailing list