Some comments on primer

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 UTC