Re: Clean-up SVG2 spec

Hi :)


2014-05-20 12:44 GMT+02:00 Tavmjong Bah <tav.w3c@gmail.com>:

> On Tue, 2014-05-20 at 09:03 +0000, Dirk Schulze wrote:
> > I would like us to clean up the SVG spec. We have many sections[1] (even
> whole chapters[2]) without any normative or even informative content.
> Usually these sections just reference a responsible CSS specification. I
> don’t think that we should produce this much noise in the specification
> itself.
>
> I guess I have a different vision from Dirk about what a specification
> should be. I believe that one should be able to read a specification and
> be able to see the whole picture of what the specification is about.
> Removing whole sections and chapters make that more difficult. For
> example, I believe that the 'Filters' chapter should not be removed but
> should instead have a one or two paragraph explanation of what filters
> are followed by one or two examples before sending the reader off to the
> CSS Filters specification for the details. Removing this material may
> make writing a specification easier but makes understanding it harder.
>

Beyond implementors, this would be very helpful for authors who wish to
read the spec (and there are more than we think)


> > We should remove all redundancy. Something that I discovered[4] in the
> SVG spec lately is a section about CSS Shapes (shape-inside/shape-outside).
> These sections shouldn’t be handled in SVG at all. If SVG needs some
> specific behavior, work together with the spec authors of the CSS spec to
> get this behavior in there. CSS specs are not just for HTML but for markup
> languages in general — including SVG. CSS Transforms, Filter Effects,
> Geometry Interfaces, CSS Blending and Compositing, CSS Colors and CSS
> Masking are examples of specs defining special behavior for SVG as needed.
>
> I agree we should be working with CSS more closely on this. I do,
> though, think we need to list the properties and give examples of how
> they apply to SVG.
>

Again, such examples will help authors.
And if those examples are normative, it means we could use them as
implementation test :)
-- 
Jeremie
.............................
Web : http://jeremie.patonnier.net
Twitter : @JeremiePat <http://twitter.com/JeremiePat>

Received on Tuesday, 20 May 2014 11:06:55 UTC