Content Selection Primer sec. 4.1.1 XML syntax and terminology, and editorial errors from Daniel Barclay on 2007-01-30 (public-diselect-editors@w3.org from January to March 2007)

From: Daniel Barclay <daniel@fgm.com>
Date: Tue, 30 Jan 2007 18:04:10 -0500
To: public-diselect-editors@w3.org
Message-ID: <45BFCEEA.2060406@fgm.com>

Regarding the Content Selection Primer draft at
http://www.w3.org/TR/2007/WD-cselection-primer-20070109/ :

Section 4.1.1 says:

    ... The characters &gt; represent the way that the >symbol
    must be written to be syntactically valid within an XML
    document.  The symbol > is reserved in XML to identify the
    start of an element.

Note the effective syntax error (a ">" character identifies
an _end_; "<" is what identifies the start).

And it's the end of a _tag_, not the end of an _element_.

Also, note the missing space in ">symbol" in the first quoted
sentence.

Additionally, the string "&gt;" should be quoted.

(I think the greater-than character should be quoted instead
of being set off only by being in bold type, but I can't make
that argument as strongly.  The base argument is that that's
standard English style.  An additional argument is that a
quoted form would survive a text-only cut and paste.  A
stronger version of that is that a quoted form would still
be visible when regular and bold text isn't rendered
differently, e.g., at small font sizes, or in a text-only
browser.)



Daniel

Received on Tuesday, 30 January 2007 23:04:25 UTC