On Wed, Feb 11, 2015 at 10:33 AM, Rick Byers <rbyers@google.com> wrote:
> I've also reviewed the changes and added a couple comments. Thanks
> Patrick!
>
> On Wed, Feb 11, 2015 at 9:10 AM, Patrick H. Lauke <redux@splintered.co.uk>
> wrote:
>
>> On 10/02/2015 19:57, Jacob Rossi wrote:
>>
>>> I added a couple minor comments to the PR. We probably should have
>>> some sort of summary section that says what's changed since the
>>> initial REC. Could you add that? Something like what's in the
>>> Pointer Events spec's appendix.
>>>
>>
>> Worth doing it now, or when we're ready to publish? In meantime, if it's
>> only on github, people can view a complete breakdown of commits...
>
>
> I'd argue it's fine to wait until we publish to synthesize this from the
> GitHub commit list. We should make an effort to have descriptive one-line
> commit summaries and descriptions to make that job easier.
>
> This all reminds me of 'ChangeLog' files in WebKit - the value doesn't
> justify the added burden on each commit IMHO.
>
I second Rick's remark. If the commit messages are descriptive enough
(should be part of the review process, I guess) then generating them from
the commit messages should be fairly easy.
--
Sangwhan Moon [Opera Software ASA]
Software Engineer | Tokyo, Japan