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

Some comments on primer

From: Martin J. Duerst <duerst@w3.org>
Date: Wed, 11 Oct 2000 16:40:13 +0900
Message-Id: <4.2.0.58.J.20001011161358.0325a310@sh.w3.mag.keio.ac.jp>
To: fallside@us.ibm.com
Cc: www-xml-schema-comments@w3.org
Hello David,

I'm re-reading the primer, and want to send you a few comments:

(I haven't found any i18n problems yet; thanks for your work!)

- I would find it helpful if e.g. at the end of 2.1, there would
   be a remark that says that the sequence of elements on the top
   level doesn't matter.

- You told me what SKU means, but I forgot. Is it possible to
   add the expansion in parentheses at the first occurrence?
   That will also help translators.

- In table 2, NMTOKENS, the comma after UK looks confusing.
   Maybe a <br> after the comma can help the readers.

- Table 2, note (2): The wording is confusing, because most other
   types cannot be reflected in DTDs, neither in elements nor in
   attributes. I would propose something like: "These simple types
   are provided for compatibility with DTDs, but please note that
   in DTDs, they can only be used for attributes."

- In section 2.3:  'one the most useful' -> 'one of the most useful'.

- 2.3.1, list types: I understand what you mean by 'you should be careful
   using fixed length list types whose base type is string', but I think
   it's better to remove 'fixed length', because care has to be taken
   in both cases. In the fixed length case, a validation error will
   be produced, whereas in the variable length case, the interpretation
   later will be wrong.

- Every W3C technical report should have an email address for comments.
   For a Recomendation, that may be changed to an errata mailing list.
   [A Recommendation also needs a link to a page listing translations.]

So much so far.

Regards,    Martin.
Received on Wednesday, 11 October 2000 03:39:04 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 6 December 2009 18:12:48 GMT