[Comment on ITS WD] Too many places to look

Comment from the i18n review of:
http://www.w3.org/TR/2006/WD-its-20060518/

Comment 40
At http://www.w3.org/International/reviews/0606-its/
Editorial/substantive: E
Owner: RI

Location in reviewed document:
General

Comment: 
To get a clear picture of the data categories you need to flick between section 5.1 (which i initially ignored because i thought it was just a 'summary'), 6.1, and the data category section, plus various bits such as parts of 5.3. This is really hard work! Can't we at least merge 5.1 and 6.1 into the data category sections. (If we want to keep them as summaries we could make a copy in the Appendices.)


FS: I disagree with your proposal. Merging 5.1 and 6.1 into the data category sections would make spec reading *very hard* for people who are interested in the general concepts of ITS, and who possibly only implement a single data category.


I18n: We are happy to repeat the information currently in summary form in 6.1, butwe would still like to see that information copied into the data categories. We think we need to find a way to make life easy for people interested in general concepts while not making it harder for people who need to implement the data categories. And we think that whether you want to implement one category or several, you'd be better off not having information scattered around the document. 


I strongly contend that section 5.1 should be merged into the data categories - and that at the very least it should not been titled 'Summary' since it is not summarizing at all. A summary draws information from elsewhere and condenses it. This section is setting out an initial set of information, some of which is only found here.


Also in the scope of the selection is specified for the local case in 6.3.2 but that for the global rules (only!) is specified in 6.1. This sort of inconsistency makes it worse.

Received on Tuesday, 11 July 2006 19:36:51 UTC