[webkit-dev] Changes to prepare-ChangeLog
mjs at apple.com
Thu Jul 9 01:47:16 PDT 2009
I discussed with Mark Rowe on IRC a bit and it seems like it would be
nice if the bug URL could be short enough to just go on one line with
the summary. Which turns out to be totally doable. Thus the latest
format proposal (the /b/ URL is a redirect):
2009-07-08 Maciej Stachowiak <mjs at apple.com>
- <http://webkit.org/b/27098> Make prepare-ChangeLog less shouty
Reviewed by Mark Rowe.
Hypothetical long description goes here. Yeah. Very long and detailed
On Jul 9, 2009, at 1:32 AM, Maciej Stachowiak wrote:
> 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
> 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
> - 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
More information about the webkit-dev