Re: PR of my proposed errata

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

Received on Friday, 13 February 2015 07:10:50 UTC