Various comments on XML Infoset last call

The spec is in good shape, my comments are mostly
editorial:

- In the TOC, expand section 2 by one level, so that it's easy to
  jump directly to any of the info items (this is what many
  people looking at the spec will want to do).

- In the paragraph just before 2.1, you say 'Note that peripheral
  information items can, and do, have core properties.' When I read
  this, I was confused. An explanation follows very much later,
  in Conformance. Please give more information in 2., so as not
  to leave the reader confused.

- Various expansions of [children] lists (e.g. [children - comments]:
  All these contain the text 'added to the ordered list of children'.
  Changing 'children' to '[children]' will make it clearer where
  things get actually added.

- 2.2.2.8: 'distinct from that previously mentioned': Which 'that'?

- 2.4.1. Why does [content] say 'a string representing', but
  'target' doesn't? Also, the definitions are a bit involved,
  content both denoting all of the content of a PI and only
  what's left after the PI target. Probably the WG already
  searched thoroughly for a better name than 'content'.
  An improvement could be made, however, by changing the definition
  of target to something like 'the target of the PI', and
  if necessary refering to production 17 in the XML spec.
  This removes the word 'content' from the definition.

- 2.6: 'logically-separate' -> 'logically separate'

- 2.11, 2.12, 2.13, 2.14: 'an peripheral' and 'an general':
  'an' -> 'a'.

- Example: The example should not only give the core information
  items, but also the peripheral ones. The phrase 'will contain
  at least' should clearly be connected to terminology used
  elsewhere, e.g. core vs. peripheral.

- References should be separated into normative and non-normative.

- Unicode (3.0!) and/or ISO 10646 should be referenced, from 2.6.1.1.


Regards,   Martin.


#-#-#  Martin J. Du"rst, World Wide Web Consortium
#-#-#  mailto:duerst@w3.org   http://www.w3.org

Received on Tuesday, 4 January 2000 04:51:02 UTC