W3C home > Mailing lists > Public > public-sml@w3.org > March 2009

action-210 namespace document review

From: John Arwe <johnarwe@us.ibm.com>
Date: Fri, 27 Mar 2009 11:36:19 -0400
To: public-sml@w3.org
Message-ID: <OF5DF4E9E6.0971D612-ON85257586.004A528E-85257586.0055B834@us.ibm.com>
I did my best to organize these comments: a list of number/comment pairs, 
and then the comment numbers that apply to each file I looked at.  I also 
looked at the meeting minutes to see if we had already decided on how to 
handle these.  In the interests of using Henry's time wisely, I think the 
working group will need to weigh in on a few of them (e.g. C1, C2, 
generically "style") generally, and then as a second criteria it will need 
to decide how far back in time to apply them.  I seem to remember for 
instance that we said we would not update those before 2008/09 (or before 
the undated CR level?) for C1 and C2, but I cannot find such a statement 
in any minutes.  Others of a "broken link" nature we can use the same 
approach for, but I suspect I know where the consensus will land on those. 
 If members care to provide general rules along those lines in advance of 
the next telecon, we should be able to move things along faster.

C1 = Title of the form "... 1.1 Namespaces" (plural) should be singular 
[1] [2]
C2 = 2nd paragraph of the form "This document describes the ... 1.1 
namespaces." (plural) should be singular [1] [2]
C3 = 2nd paragraph of the form "This document describes the ... 1.1 
namespaces." -- "the" looks strange, even after changing the plural to 
singular, since the spec defines more than one (but the document describes 
only one) ... perhaps "a" instead?
C4 = "It also contains a directory of links to these related resources, 
using Resource Directory Description Language." -- drop 'these'?
C5 = "The namespace identified by the URI ... is defined in the ..., 
Version 1.1. " -- add 'specification' before the full stop?
C6 = "The schema document at ... will not change but will be retained 
without modificaiton, ..." -- drop 'will not change but' as redundant?
C7 = (total nit) "The schema document at ...  will not change ..." -- 
extra space after NSURI
C8 = (typo) "...  will be retained without modificaiton, ..." -- iton -> 
tion
C9 = links to dated URI instead of TR space (and throws a 404)
C10 = links to SML instead of SMLIF
C11 = links to http://www.w3.org/2008/12/sml-schema.xsd (error 404)
C12 = "This is a URI defined in..." followed by "N.B. the URI (...), is 
NOT a namespace specified by ..." -- not sure if we should nuke the doc, 
or re-phrase the content.  fwiw, when I tried to rephrase sensibly I 
quickly got tied up in knots because of the URI date-specificity (i.e. it 
is NOT true that any draft -ever- used this URI).  That leads me to think 
we should nuke it, instead of defining which URIs we do NOT use ... an 
infinite set, of course).  Note that the 2007/08 sml-err ns document DOES 
say that it was not used after that point.  In my mind that should be 
sufficient.  We might also have the "placeholders" redirect to 
http://www.w3.org/ns/sml-err which does a pretty good job of explaining 
things IMO.
C13 = "Interchange Format" but this is defined in SML, not SML-IF (several 
places)
C14 = change 2008/09 to 2008/03
C15 = link to dated schema document throws 403 (insufficient access privs)
C16 = inconsistent use of comma before "version 1.1" in title... e.g. SML 
has the comma, other 2 do not
C17 = "normative definition" link is getting redirected to 
http://www.w3.org/TR/2008/WD-sml-20081125/ which throws 404
C18 = undated schema link redirects to 
http://www.w3.org/2008/25/sml-if-schema.xsd which throws 404 (and the 
2008/25 value just looks wrong)



C5, C6, C7, C9, C15             http://www.w3.org/ns/sml-if.html
C5, C6, C7, C9, C15, C17, C18   http://www.w3.org/ns/sml-if.xhtml
C5, C6, C7, C9, C15             http://www.w3.org/ns/sml-if

C5, C6, C7, C8, C9, C15                 http://www.w3.org/ns/sml.html
C5, C6, C7, C9, C15             http://www.w3.org/ns/sml.xhtml
C5, C6, C7, C8, C9, C16                 http://www.w3.org/ns/sml

C17                             http://www.w3.org/ns/sml-err.html
C17                             http://www.w3.org/ns/sml-err.xhtml
C17                             http://www.w3.org/ns/sml-err

C5, C9, C13                     http://www.w3.org/ns/sml-function.html
C5, C9                          http://www.w3.org/ns/sml-function.xhtml
C5, C9, C13                     http://www.w3.org/ns/sml-function



C1, C2, C10             http://www.w3.org/2008/09/sml-if.html
C1, C2, C4, C10                 http://www.w3.org/2008/09/sml-if.xhtml

C1, C2, C3              http://www.w3.org/2008/09/sml.html
C1, C2, C3, C4          http://www.w3.org/2008/09/sml.xhtml

C1, C2, C3, C12                 http://www.w3.org/2008/09/sml-err.html
C1, C2, C3, C4, C12     http://www.w3.org/2008/09/sml-err.xhtml

C1, C2, C3, C13                 
http://www.w3.org/2008/09/sml-function.html
C1, C2, C3, C4, C13     http://www.w3.org/2008/09/sml-function.xhtml



C1, C2, C10             http://www.w3.org/2008/03/sml-if.html
C1, C2, C4, C10                 http://www.w3.org/2008/03/sml-if.xhtml

C1, C2                  http://www.w3.org/2008/03/sml.html
C1, C2, C4              http://www.w3.org/2008/03/sml.xhtml

C1, C2, C12             http://www.w3.org/2008/03/sml-err.html
C1, C2, C4, C12                 http://www.w3.org/2008/03/sml-err.xhtml

C1, C2, C3, C13         http://www.w3.org/2008/03/sml-function.html
C1, C2, C3, C4, C13     http://www.w3.org/2008/03/sml-function.xhtml



        http://www.w3.org/2007/08/sml
C10     http://www.w3.org/2007/08/smlif
        http://www.w3.org/2007/08/sml-function
C14     http://www.w3.org/2007/08/sml-err

[1] 
http://lists.w3.org/Archives/Public/public-sml/2009Jan/att-0025/20090115-sml-minutes.html#item04
[2] 
http://lists.w3.org/Archives/Public/public-sml/2009Jan/att-0058/20090122-sml-minutes.html#item03


Best Regards, John

TACCT: Simplicity is ultimate sophistication 
                                        -- Leonardo da Vinci
Street address: 2455 South Road, P328 Poughkeepsie, NY USA 12601
Voice: 1+845-435-9470      Fax: 1+845-432-9787
Received on Friday, 27 March 2009 15:37:01 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 27 March 2009 15:37:02 GMT