W3C home > Mailing lists > Public > www-xml-schema-comments@w3.org > April to June 2000

minor comments for WD-xmlschema-1-20000407

From: Susan Lesch <lesch@w3.org>
Date: Wed, 10 May 2000 19:41:36 -0800
Message-Id: <v04210101b53fc9c2e6aa@[24.25.222.186]>
To: www-xml-schema-comments@w3.org
Cc: w3t-comm@w3.org
These are just a few minor editorial comments on your Last Call 
draft, XML Schema Part 1: Structures [1] "work in progress." Please 
feel free to ignore or use them as you see fit.

In the interest of advancing schemas in practice, perhaps in the 
Abstract or in Introduction section 1, you could identify your 
audience, encourage them, and (like MathML) explain that this is not 
a user's guide for the general public. This specification is 
carefully and beautifully done, but it was a mystery for me on one 
reading, even after reading the Primer.

Both Webster's (en-US) and the concise Oxford dictionaries list the 
"z" rather than the "s" form of these words first: normalisation, 
normalised, optimise, standardised, and characterisation. They could 
be changed to z's.

The text does not refer to most of the References (Cambridge 
Communique, DCD, DDML, ISO-11404, and so on). I'm not certain they 
need to be there, especially the old URI RFCs.

Though I didn't correct this here, apparently the use of "we" is 
frowned on in specifications. I don't yet have a proper reference for 
you. One reason is in the final paragraph of 
http://lists.w3.org/Archives/Public/www-xml-linking-comments/2000JanMa 
r/0079.html which explains that first person English is hard to 
translate.

muzmo.com and foo.com are registered domains. You could consider 
using example.com, example.net, and example.org which IANA registered 
for examples. (See RFC 2606 section 3 at 
http://www.ietf.org/rfc/rfc2606.txt.)


Minor typos (quotes are followed by a suggestion)
-----------

2.2.1.3 par. 1
with respect to particular simple type
with respect to a particular simple type

2.2.1.3 par. 2, list items 1 and 3
A restriction
a restriction

3.4 table - {content type}, and 3.4 par. 11, and 3.13 par. 7
I.e
i.e.,

3.7 par. 3
{compositor}determines
{compositor} determines

3.13 par. 11
. therein.
.

4.3.3 table {content type} 4.4.2.3
the the
the

5.1 list item 4 has a subheading 4 (that should perhaps be 4.1 or 1).

In 5.11, the first sentence is repeated in the third line

5.11 note in 1.1.6
It is trivially
It is trivial

6.3.1 par. 1
mime
MIME

6.3.2 list item 2 note, and 6.3.2 last par.
recommendation
Recommendation

B. line 3
The the
The

B. line 172
exculsive
exclusive

D.
HTML 4.0 Specification
HTML 4.01 Specification

RFC 1808,Relative
RFC 1808, Relative

RFC 1738,Uniform
RFC 1738, Uniform

RFC 2141,URN
RFC 2141, URN

XSchema
c/xscspecv4.htm For more
c/xscspecv4.htm. For more

[1] http://www.w3.org/TR/2000/WD-xmlschema-1-20000407/

Best wishes for your project,
-- 
Susan Lesch
Intern, W3C
Received on Wednesday, 10 May 2000 22:41:44 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 14:49:52 UTC