"removing red" from the spec

As we rework parts of the SVG 2 spec, or add new sections and 
paragraphs, we should be removing the red background which indicated 
that the text is identical or substantially the same as what was in SVG 
1.1.  The background for the entire document is set to red by the style 
sheet, and the following two classes are used to indicate different 
levels of maturity:

   ready-for-wg-review
     Indicates that someone has assessed a section/paragraph as being
     fine, or have rewritten it to be of a higher quality than what was
     in SVG 1.1.  This gives the section a light yellow background.

   ready-for-wider-review
     Indicates that nobody in the WG has raised any objections over the
     verified existing or rewritten text.  This gives the section our
     familiar white background.

My suggestion is that as we as individuals rewrite poorly written 
sections of the SVG 1.1 text or add new sections, and once we are happy 
with them, we mark them as "ready-for-wg-review".  Wrapping the section 
in a <div> with this class should be sufficient, if there are multiple 
elements involved.  (I don't think doing this at less than a paragraph's 
granularity would be useful.)

Then, once we come to decide to publish a Working Draft of the document 
(and of course at any point beforehand), the WG can have a short amount 
of time to review any of the ready-for-wg-review sections in the 
document.  If nobody objects to them, then they can all be switched to 
ready-for-wider-review just before publication.

For example, I have just committed a change to remove mentions of the 
SVG 1.1 DTD throughout the body of the spec:

   http://svgwg.org/hg/svg2/rev/22ffd798f6c0

Some of the changes are small wording changes in the middle of 
paragraphs, and I have left those with a red background since we'll need 
to properly assess what's in the surrounding text.  But I rewrote the 
Namespaces and DTD section in intro.html by substantially shortening it, 
and for the moment I don't intend to edit it further, so I have marked 
it as ready-svg-wg-review:

   https://svgwg.org/svg2-draft/intro.html#Namespace

(I might try to rework the styles for these classes so that the colour 
extends to the left and right margins of the page.)

Received on Thursday, 17 May 2012 09:38:24 UTC