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  <m...@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

_______________________________________________
webkit-dev mailing list
webkit-dev@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-dev

Reply via email to