W3C home > Mailing lists > Public > whatwg@whatwg.org > November 2011

[whatwg] WHATWG on Google+

From: Aryeh Gregor <ayg@aryeh.name>
Date: Wed, 23 Nov 2011 09:36:49 -0500
Message-ID: <CAKA+Ax=kO-sh3BYPBBoZgmup1gMg8qkomd04+NS3DwFOZBgcDg@mail.gmail.com>
On Mon, Nov 21, 2011 at 11:43 PM, Silvia Pfeiffer
<silviapfeiffer1 at gmail.com> wrote:
> However, I don't think this rough classification actually helps me
> much to identify what I want to look at. If at least the area of
> change is mentioned in your descriptive text, that would help me much
> more. For me "media" (or "video") and "webvtt" are of particular
> interest. I am particularly annoyed when I read things like "Forgot to
> remove this now false note" but don't know which spec area it applies
> to - if it's in "media" I will check no matter whether [e] or [c], if
> it's in - say - "tables", I likely won't care.

I agree that it would be helpful if commit messages were more
informative.  For editorial changes, you often don't mention anything
that gives a clue about the subject of the commit.  E.g.:

http://lists.whatwg.org/pipermail/commit-watchers-whatwg.org/2011/004902.html
"pedantic nit: spec required a valid value	but then required the empty
va [...]"

That commit is apparently relevant to date parsing, but you can't tell
without looking at the diff, which is often hard to decipher if
there's not enough context.  You're generally good about informative
commit messages for non-editorial changes, but editorial changes are
often interesting too.  (Otherwise, why not just remove all the
non-normative parts of the spec?)
Received on Wednesday, 23 November 2011 06:36:49 UTC

This archive was generated by hypermail 2.3.1 : Monday, 13 April 2015 23:09:09 UTC