More comments

Hi,

during my testing of NVDL schema I read whole spec again. I found
several small typos. Here it goes:

- 1st note in section 3.4
"The selection of the ITS data categories applies to *text nodes*..."
I think that word "text" should be removed, because you can select
attribute which is itself node with value and doesn't have any text node
attached.

- example 19: typos in XPath expessions
//title|author  ==> //title|//author
//prolog/title|author ==> //prolog/title|//prolog/author

- examples 26 and 27
There are references like ErrorInfo.html/#NotFound. This looks quite
strange and while I can imagine that web server could be configured to
handle such request, I think that having just ErrorInfo.html#NotFound
(i.e. without / before fragment identifier) would be better.

- appendix D (Schemas for ITS)
I'm wondering whether this section should contain some brief explanation
of usage of those schemas. Readers can get impression that they can use
those schema for validation of documents containing ITS markup or
consisting solely of <its:rules> element. But this is not true because:

* RELAX NG schema contains only named patterns and doesn't have start
directive. This means that this schema can't validate anything itself,
it is just a set of building block which can be used by other schemas.

* XSD and DTD schemas define all elements as global. This means that you
can validate also document which contains for example
<its:translateRule> element without enclosing <its:rules>. And of course
it is not possible to validate other documents than ones consisting only
from ITS markup.

We could add something like:
"The following schemas define ITS elements and attributes and could be
used as building blocks when you want to integrate ITS markup into your
own XML vocabulary. You can see examples of such integration in [BP].
Those schemas are not intended to be used alone for validation of
documents with ITS markup. For such validation you can use NVDL schema
provided in [appendix X]."

- appendix E (Schematron schema for ITS)
Schematron example uses http://www.ascc.net/xml/schematroin namespace.
In the last year Schematroin was improved and approved as ISO standard.
I think that referencing ISO version of Schematron would be better as it
is real standard. For our purpose only change would be in bibliography
reference and namespace will change to
"http://purl.oclc.org/dsdl/schematron"

HTH,

			Jirka

-- 
------------------------------------------------------------------
  Jirka Kosek     e-mail: jirka@kosek.cz     http://www.kosek.cz
------------------------------------------------------------------
  Profesionální školení a poradenství v oblasti technologií XML.
     Podívejte se na náš nově spuštěný web http://DocBook.cz
       Podrobný přehled školení http://xmlguru.cz/skoleni/
------------------------------------------------------------------
                   Nejbližší termíny školení:
** XML pro vývojáře 19.-22.3.2007 ** XML schémata 16.-18.4.2007 **
        ** XSL-FO 15.-16.5.2007 ** DocBook 26.-28.6.2007 **
------------------------------------------------------------------
  http://xmlguru.cz    Blog mostly about XML for English readers
------------------------------------------------------------------

Received on Monday, 29 January 2007 10:39:01 UTC