W3C home > Mailing lists > Public > public-svg-wg@w3.org > July to September 2011

Re: SVG 2 and its Mercurial repositories

From: Cameron McCormack <cam@mcc.id.au>
Date: Mon, 01 Aug 2011 12:03:36 +1200
Message-ID: <4E35ED58.7070200@mcc.id.au>
To: Tavmjong Bah <tavmjong@free.fr>
CC: Jonathan Watt <jwatt@jwatt.org>, SVG WG <public-svg-wg@w3.org>
On 31/07/11 6:24 PM, Tavmjong Bah wrote:
> Can we also add an "annotation" div class? This would be used to keep
> notes, for example:
>
> <div class="annotation">
>    <p>Resolved to add 'fr' to radialGradient in SVG 2.0 at 2011-07-29 WG
> meeting to align with use by canvas.</p>
> </div>
>
> The display of annotations would be hidden or shown by style sheets.
> They would be hidden in public versions (and could be stripped in the
> final version if desired, although, they would be very useful for
> keeping a historical record of why things were done the way they are).

It's an interesting idea, although I would in general try to keep 
metadata in the spec source itself to a minimum to avoid it becoming out 
of date.  I have tended to (encouraged others to) note the ACTION or 
ISSUE in commit messages when making changes to the spec, so that there 
is a way of recording this kind of information.  Do you think it would 
better to include this description directly in the spec?  Opinions from 
others?
Received on Monday, 1 August 2011 00:04:10 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:13 UTC