Comments on ITS 2.0 draft

Hi all,

Jörg Schütz kindly provided comments on the ITS 2.0 draft, see below. I
will put these on the agenda for the week after next week, that is when we
have more people on the call.

Best,

Felix


1. Move "Usage of HTML5" as indicated in ed. note. 1.5 Out of Scope. Note
uses old definition of "XML localization properties", should be updated.

2. All examples might take "version='2.0'", or make a note to identicate
the backward compatibility.

3. 1.4.2 Example 7: We don't need xlink:type; delete every reference (this
is in accordance with the ed. note in 5.3 and the definition in 5.2.1.

4. 2.1 Selection. What does "ITS markup may take different shapes." mean?
Be more specific. What about XPath 2.0 as well as XQuery, XSLT 2.0/3.0, and
of course CSS 3; say something about relationships and/or support to/in ITS
2.0.

5. 2.2 Overriding and inheritance. Example is quite intuitiv, but "header"
should be also "head element".

6. 3.4 Selection. Misleading example, make explict which string should be
translated.

7. 5.2.1 Global, Rule-based Selection. Ordered item list before Example 15:
"an namespace declarations" should be "a namespace declaration" or
"namespace declarations".

8. 5.2.2 Global selection within HTML5.  Should be "... HTML5 parsing
produces a DOM tree which..."

9. 5.4. "Any rules..." should be "Any rule...". "In case of conflicts ...
rule element" should be "... rules element...". Example 21: use of "|"
should be described consistently, i.e. "and" vs. "or".

10. 5.5. Example 22 needs some explanation otherwise it's quite isolated.

11. 5.6. What kind of conversion is intended?

12. 6.2.3. Mention that "translate" is a HTML5 attribute otherwise it
should have been "its-translate" to be consistent with the other markup
declarations, e.g. Localization Note, Terminology, etc.

13. 6.5.3. Same as 12. for "dir" in HTML5 otherwise "its-dir".

14. 6.6.3 and 6.7.3 need the HTML5 declaration.

15. 6.9 Domain. Description needs language streamlining... What does the
second bullet point exactly mean? What are "workflow specific values"? What
the following example specifiy a valid rule?
<its:rules version="2.0">
   <its:domainRule selector="/html/body"

 domainPointer="/html/head/meta[@name='keywords'|@name='description']/@content"/>
</its:rules>

16. 6.10 - 6.13. That's a pity the most interesting new declarations are
postponed... :-(


-- 
Felix Sasaki
DFKI / W3C Fellow