Re: minor comments for WD-xmlschema-1-20000407

Thanks for your careful reading.

Susan Lesch <lesch@w3.org> writes:

> 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.

Good idea.

> 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.

I'll check my UK dictionary -- as a UK (naturalised :-) speaker, I've
used UK spelling throughout.

> 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.

Right.

> 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.

But I hate the academic passive, which is the obvious alternative . . .

> 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.)

Agreed.

ht
-- 
  Henry S. Thompson, HCRC Language Technology Group, University of Edinburgh
          W3C Fellow 1999--2001, part-time member of W3C Team
     2 Buccleuch Place, Edinburgh EH8 9LW, SCOTLAND -- (44) 131 650-4440
	    Fax: (44) 131 650-4587, e-mail: ht@cogsci.ed.ac.uk
		     URL: http://www.ltg.ed.ac.uk/~ht/

Received on Thursday, 11 May 2000 05:24:57 UTC