This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 3017 - rename documentRules and documentRule
Summary: rename documentRules and documentRule
Status: CLOSED FIXED
Alias: None
Product: ITS
Classification: Unclassified
Component: ITS tagset (show other bugs)
Version: WorkingDraft
Hardware: PC Windows XP
: P2 normal
Target Milestone: LastCall20May
Assignee: Felix Sasaki
QA Contact: Felix Sasaki
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2006-03-19 23:08 UTC by Felix Sasaki
Modified: 2006-07-24 10:30 UTC (History)
0 users

See Also:


Attachments

Description Felix Sasaki 2006-03-19 23:08:34 UTC
I propose to rename "documentRules" to "globalRules" and "documentRule" to "globalRule".
The name "documentRule(s)" was based on the difference to "schemaRule", which does not exist anymore.
Comment 1 Christian Lieske 2006-03-20 09:44:42 UTC
I suggest to go for "itsRule(s)" instead. This name more clearly indicates what the rules are about.

Best regards,
Christian
Comment 2 Yves Savourel 2006-03-20 13:35:59 UTC
Maybe just "rules" would do?
-ys
Comment 3 Felix Sasaki 2006-03-20 13:59:42 UTC
This bug depends on the proposal for ITS schema redesign (bug 3016). A crucial part of the design proposal is to have a clear separation "global" versus "local", which we have in the whole draft.
Another point: One kind of rule, that is "selecting some nodes and adding information to them", is still related to what we do with ITS locally. See http://lists.w3.org/Archives/Public/public-i18n-its/2006JanMar/0366.html for further information. In other words: I would propose to keep the distinction "global" versus "local".
Comment 4 Yves Savourel 2006-03-22 16:54:03 UTC
This issue (Bug #3017) is one of the topics for discussion this week (and
decision at the Wed Mar-29 teleconference).

Summary:

1) The question: how should the current 'documentRules' should be named?

Since we don't have schemaRules the name documentRules may not be appropriate anymore. [Note that the renaming of documentRule is resolved since we decided to go for translateRule, termRule, etc.]

Several names are proposed: globalRules, itsRules, rules.


2) The question: what should be the suffix for the 'value passing/pointing' attribute?

The name of the attributes that use to be called xyzMap in the Mandelieu proposal need to reflect their 'value passing/pointing' aspect rather than a 'mapping' that is something different. This applies for: locInfoMap, locInfoRefMap, rubyBaseMap, rubyTextMap, termRefMap, etc.

Several suffixes are proposed: xyzPointer, xyzPassThrough, xyzValue (and I may forget some).


My personnal (current) option:

1) rules
2) xyzPointer

-yves
Comment 5 Felix Sasaki 2006-03-23 01:22:45 UTC
(In reply to comment #4)
> This issue (Bug #3017) is one of the topics for discussion this week (and
> decision at the Wed Mar-29 teleconference).
> 
> Summary:
> 
> 1) The question: how should the current 'documentRules' should be named?
> 
> Since we don't have schemaRules the name documentRules may not be appropriate
> anymore. [Note that the renaming of documentRule is resolved since we decided
> to go for translateRule, termRule, etc.]
> 
> Several names are proposed: globalRules, itsRules, rules.
> 
> 
> 2) The question: what should be the suffix for the 'value passing/pointing'
> attribute?
> 
> The name of the attributes that use to be called xyzMap in the Mandelieu
> proposal need to reflect their 'value passing/pointing' aspect rather than a
> 'mapping' that is something different. This applies for: locInfoMap,
> locInfoRefMap, rubyBaseMap, rubyTextMap, termRefMap, etc.
> 
> Several suffixes are proposed: xyzPointer, xyzPassThrough, xyzValue (and I may
> forget some).
> 
> 
> My personnal (current) option:
> 
> 1) rules
> 2) xyzPointer
> 
> -yves
> 

+1 for xyzPointer
-1 for "rules". This has to do with the schema redesign proposed at http://lists.w3.org/Archives/Public/public-i18n-its/2006JanMar/0301.html . For each data category, so far we had the discinction "global" versus "local", which is also in the schema. So I would propose "globalRules".
Comment 6 Christian Lieske 2006-03-27 09:27:51 UTC
I would go for 'its:globalRules' since this would make it very clear (from my understanding) that the corresponding markup 

1. has to do with ITS
2. has to do with global ITS information
3. is rule-like in nature

Example:


<its:globalRules>
  <its:tranlateRule .../>
</its:globalRules>

My runner up would be 'its:global' since the contents of 'itsGlobal' would make it clear that 'its:global' holds rule-like info.

<its:global>
  <its:tranlateRule .../>
</its:global>

Best regards,
Christian
Comment 7 Felix Sasaki 2006-03-27 11:39:37 UTC
(In reply to comment #6)
> I would go for 'its:globalRules' since this would make it very clear (from my
> understanding) that the corresponding markup 
> 
> 1. has to do with ITS
> 2. has to do with global ITS information
> 3. is rule-like in nature
> 
> Example:
> 
> 
> <its:globalRules>
>   <its:tranlateRule .../>
> </its:globalRules>
> 
> My runner up would be 'its:global' since the contents of 'itsGlobal' would make
> it clear that 'its:global' holds rule-like info.
> 
> <its:global>
>   <its:tranlateRule .../>
> </its:global>
> 
> Best regards,
> Christian
> 
+1 for its:globalRules
++1 for its:global
Comment 8 Sebastian Rahtz 2006-03-27 12:20:15 UTC
Since we don't have local rules, saying <globalRules> seems
redundant to me. The discussion in http://lists.w3.org/Archives/Public/public-i18n-its/2006JanMar/0301.html
about distinguishing local from global is not relevant,
as there is no local corollary of <globalRules>. Using
the word "global" raises falses expectations.

I'd go for <ITSRules>, on the grounds that
these elements may appear in an instance document's
header section, and its nice if they are human
parseable.

Sebastian
Comment 9 Felix Sasaki 2006-03-27 12:23:46 UTC
(In reply to comment #8)
> Since we don't have local rules, saying <globalRules> seems
> redundant to me. The discussion in
> http://lists.w3.org/Archives/Public/public-i18n-its/2006JanMar/0301.html
> about distinguishing local from global is not relevant,
> as there is no local corollary of <globalRules>. Using
> the word "global" raises falses expectations.
> 
> I'd go for <ITSRules>, on the grounds that
> these elements may appear in an instance document's
> header section, and its nice if they are human
> parseable.
> 
> Sebastian
> 

If I count right that means
rules: Christian(?), Sebastian, Yves
global something: Felix
which means I'm out.
Rules would be o.k. with me, so <its:rules>.
Comment 10 Sebastian Rahtz 2006-03-27 16:48:53 UTC
> Then maybe using XLink's simple link would be better: not re-inventing
> > something and keeping it processable by simple tools. I'm not very familiar
> > with XLink but it seems we should be able to do:
> > 
> > <its:link xlink:href="someRules.xml"/>

Without any indication of the semantics of the link, the word <link>
is still a bit odd. This would work fine, though its a pain declaring
yet another namespace, but I'd still rather see something like <rulesLink>


Comment 11 Yves Savourel 2006-04-07 20:06:20 UTC
Resolutions: <documentRules> is now <rules>
Comment 12 Felix Sasaki 2006-07-24 10:30:45 UTC
Closed, no further action necessary.