sXBL: Use proper examples

Dear Scalable Vector Graphics Working Group,

  In section 1 of the latest sXBL draft there is an example

...
  <xbl:definition element="myNS:HelloWorld>
    <xbl:template>
      <text>Hello, world, using sXBL</text>
    </xbl:template>
  </xbl:definition>
...

which is obviously not well-formed. Worse, the external example at
http://www.w3.org/TR/2004/WD-sXBL-20040901/images/examples/xbl01.svg
is neither well-formed nor valid, the external subset even refers to

  <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" 
    "http://www.w3.org/Graphics/SVG/1.2/DTD/svg12.dtd">

a resource that does not seem to exist. The example, like many examples
in the document, is also a rather poor one, it does not demonstrate any
features of sXBL that are not already available to authors, you could
have the exactly same effect by using

  <!DOCTYPE svg [
    <!ENTITY HelloWorld "<text>Hello, world, using sXBL</text>">
  ]>
  ...
  &HelloWorld;
  ...

or by pre-processing the document e.g. using XSLT. It is in fact a
common question from RCC/XBL/etc. newcomers why there is a need for
sXBL, and it does not rather use XSLT, this should be clearly
demonstrated by the first example in the specification. Please correct
the example, improve it to demonstrate a compelling sXBL use case and
consider adding a section that explains where sXBL (or the upcoming
general purpose XBL language) fits into the family of W3C XML document
formats, where it would be used rather than XSLT, etc.

regards.

Received on Friday, 10 September 2004 23:52:16 UTC