W3C home > Mailing lists > Public > www-html-editor@w3.org > July to September 2009

CURIE spec. editorial errors

From: Barclay, Daniel <daniel@fgm.com>
Date: Mon, 10 Aug 2009 15:29:36 -0400
Message-ID: <4A807520.4020104@fgm.com>
To: <www-html-editor@w3.org>
The document currently at http://www.w3.org/TR/curie/
(http://www.w3.org/TR/2009/CR-curie-20090116) contains several editorial
errors:


* Section 1 says:

     Moreover, in this example, we want the names within that scope to
     a URI that will reveal the meaning of that ISBN.

   (Something is missing (perhaps "to map").)


* Section 1 says

     ... the syntax of QNames is overly-restrictive ...

   The hyphen isn't needed in that case (because "overly" is an
   adverb).


* Section 1 says:

     CURIEs expand to any IRI.  QNames are treated as value pairs, but
     even if those pairs are combined into a string, only a subset of
     IRIs can be represented.

   Something is really unclear in that first sentence.  It does not
   convey the its apparent intended meaning because of its imprecision.
   (The set of all CURIEs does _not_ expand to any single IRI.)

   The paragraph should probably first be written in terms of singular
   items, e.g.: "A CURIE expands to an IRI.  A QName is treated as a
   value pair ..."  (Obviously, second, the part about being able to
   represent any IRI needs to be re-added somehow.)


* Section 2.2 says:

     ... "URI-references, IRI-references" ...

   Those hyphens are extraneous.


* Section 3 says:

     The following definition makes the set of CURIEs a syntactic
     superset of the set of QNames.  It is comprised of two
     components, a prefix and a reference. ...

       safe_curie  :=   '[' curie ']'

       curie       :=   [ [ prefix ] ':' ] reference

       prefix      :=   NCName

       reference   :=   irelative-ref (as defined in IRI)

   First, the "is comprised of" is backwards.  (A whole comprises its
   parts (or is _composed_ of them); it is not "comprised of" its
   parts.)

   Second, it is not the definition that comprises two components.
   (The first and second sentences are not coordinated right--as
   things are written, the "it" refers to "the following definition,"
   not to "a CURIE" or "the curie production.")


* Section 3 says:

     Such reserved values MUST translate into an IRI, just as with any
     other CURIE.

   That wording doesn't say what it (apparently) means.  It should say
   something like:

     Such a reserved value MUST translate into an IRI, just as with any
     other CURIE.


* Section 3 says:

     Host languages MAY define additional constraints on these syntax
     rules when CURIES are used ...

   (The "s" is capitalized.)


* Section 4.1 says:

     The [SPARQL] language provides ...

   Shouldn't that really be something like the following?

     The SPARQL language [SPARQL] provides ...

   (That is, the bracketed text represents a footnote reference, so
   the sentence should be readable without that text, right?  So
   writing "The [SPARQL] language provides ..." reads as "The
   language provides ...," which certainly isn't the intent.

   For example, see the SPARQL spec's section 1.2.2
   (http://www.w3.org/TR/rdf-sparql-query/#docDataDesc):

     This document uses the Turtle [TURTLE] data format to ...
   )



(_If_ W3C specifications are to be in American English:  The phrases
quoted with single quotes should use double quotes.)



Daniel
-- 
(Plain text sometimes corrupted to HTML "courtesy" of Microsoft Exchange.) [F]
Received on Monday, 10 August 2009 19:29:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 27 March 2012 18:17:59 GMT