[sc34wg3] Re: Comments on 13250 part3 (XML Syntax)

[Lars Marius Garshol]

Dear Naito-san,

* Motomu Naito
>
> Concerning 13250 part-3 (XML Syntax), there are some comments.
> (I sent this email to sc34wg3 at isotopicmaps.org, but it looked like  
> rejected.
> So I send this email to Moore-san and Garshol-san directly.)

Strange. Your March 16 email was not in the archives, either. Maybe  
your green.ocn.jp address is not subscribed?

> 1. Clause 4.4, first paragraph
>
>    The term "topic characteristic" is used in the paragraph, but  
> there is no explanation of it.
>    It should be defined in part-2 or part-3.

This is a mistake. This term is no longer used. We will remove it.

> 2. Clause 4.11
>
>    ScopeAble element i.e. topicName, variant, occurrence and  
> association, should be specified.
>
> 3. Clause 4.12
>
>    TypeAble element i.e. topicName, occurrence, association and  
> role, should be spedified.

We could do both of these things, but it means having to repeat  
information many times throughout the document. That inevitably leads  
to mistakes as updates happen in one place, but not in all, so I am  
very reluctant to do this.

In fact, nearly all of clause 4 is redundant, anyway. A better  
approach may be to simply get rid of it, and work the valuable bits  
into clause 5. I've been thinking about this for a couple of years,  
but never did it, in part before clause 4 had a lot more useful  
content before.

I'll see if we can get rid of clause 4 entirely.

> 4. Clause 5.1, 3rd paragraph
>
>    The term "XTM document" and "XML document" are mixed in the  
> paragraph.
>    It should be unified to "XTM document".

Good catch. We will fix this.

> 5. Clause 5.11.1 General, 4th paragraph
>
>    " ... property of the variant item created by the parent variant  
> element."
>    should be
>    " ...proerty of the variant item or occurrence item created by  
> the parent variant element or occurrence element.".

True! Thanks for catching this.

Thank you very much for reporting these issues. It is much appreciated.

--
Lars Marius Garshol, Ontopian               http://www.ontopia.net
+47 98 21 55 50                             http://www.garshol.priv.no