<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>3017</bug_id>
          
          <creation_ts>2006-03-19 23:08:34 +0000</creation_ts>
          <short_desc>rename documentRules and documentRule</short_desc>
          <delta_ts>2006-07-24 10:30:45 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>ITS</product>
          <component>ITS tagset</component>
          <version>WorkingDraft</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>CLOSED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>LastCall20May</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Felix Sasaki">fsasaki</reporter>
          <assigned_to name="Felix Sasaki">fsasaki</assigned_to>
          
          
          <qa_contact name="Felix Sasaki">fsasaki</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>8784</commentid>
    <comment_count>0</comment_count>
    <who name="Felix Sasaki">fsasaki</who>
    <bug_when>2006-03-19 23:08:34 +0000</bug_when>
    <thetext>I propose to rename &quot;documentRules&quot; to &quot;globalRules&quot; and &quot;documentRule&quot; to &quot;globalRule&quot;.
The name &quot;documentRule(s)&quot; was based on the difference to &quot;schemaRule&quot;, which does not exist anymore.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8787</commentid>
    <comment_count>1</comment_count>
    <who name="Christian Lieske">christian.lieske</who>
    <bug_when>2006-03-20 09:44:42 +0000</bug_when>
    <thetext>I suggest to go for &quot;itsRule(s)&quot; instead. This name more clearly indicates what the rules are about.

Best regards,
Christian</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8790</commentid>
    <comment_count>2</comment_count>
    <who name="Yves Savourel">ysavourel</who>
    <bug_when>2006-03-20 13:35:59 +0000</bug_when>
    <thetext>Maybe just &quot;rules&quot; would do?
-ys</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8791</commentid>
    <comment_count>3</comment_count>
    <who name="Felix Sasaki">fsasaki</who>
    <bug_when>2006-03-20 13:59:42 +0000</bug_when>
    <thetext>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 &quot;global&quot; versus &quot;local&quot;, which we have in the whole draft.
Another point: One kind of rule, that is &quot;selecting some nodes and adding information to them&quot;, 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 &quot;global&quot; versus &quot;local&quot;.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8831</commentid>
    <comment_count>4</comment_count>
    <who name="Yves Savourel">ysavourel</who>
    <bug_when>2006-03-22 16:54:03 +0000</bug_when>
    <thetext>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 &apos;documentRules&apos; should be named?

Since we don&apos;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 &apos;value passing/pointing&apos; attribute?

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

+1 for xyzPointer
-1 for &quot;rules&quot;. 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 &quot;global&quot; versus &quot;local&quot;, which is also in the schema. So I would propose &quot;globalRules&quot;.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8887</commentid>
    <comment_count>6</comment_count>
    <who name="Christian Lieske">christian.lieske</who>
    <bug_when>2006-03-27 09:27:51 +0000</bug_when>
    <thetext>I would go for &apos;its:globalRules&apos; 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:


&lt;its:globalRules&gt;
  &lt;its:tranlateRule .../&gt;
&lt;/its:globalRules&gt;

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

&lt;its:global&gt;
  &lt;its:tranlateRule .../&gt;
&lt;/its:global&gt;

Best regards,
Christian</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8891</commentid>
    <comment_count>7</comment_count>
    <who name="Felix Sasaki">fsasaki</who>
    <bug_when>2006-03-27 11:39:37 +0000</bug_when>
    <thetext>(In reply to comment #6)
&gt; I would go for &apos;its:globalRules&apos; since this would make it very clear (from my
&gt; understanding) that the corresponding markup 
&gt; 
&gt; 1. has to do with ITS
&gt; 2. has to do with global ITS information
&gt; 3. is rule-like in nature
&gt; 
&gt; Example:
&gt; 
&gt; 
&gt; &lt;its:globalRules&gt;
&gt;   &lt;its:tranlateRule .../&gt;
&gt; &lt;/its:globalRules&gt;
&gt; 
&gt; My runner up would be &apos;its:global&apos; since the contents of &apos;itsGlobal&apos; would make
&gt; it clear that &apos;its:global&apos; holds rule-like info.
&gt; 
&gt; &lt;its:global&gt;
&gt;   &lt;its:tranlateRule .../&gt;
&gt; &lt;/its:global&gt;
&gt; 
&gt; Best regards,
&gt; Christian
&gt; 
+1 for its:globalRules
++1 for its:global</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8896</commentid>
    <comment_count>8</comment_count>
    <who name="Sebastian Rahtz">sebastian.rahtz</who>
    <bug_when>2006-03-27 12:20:15 +0000</bug_when>
    <thetext>Since we don&apos;t have local rules, saying &lt;globalRules&gt; 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 &lt;globalRules&gt;. Using
the word &quot;global&quot; raises falses expectations.

I&apos;d go for &lt;ITSRules&gt;, on the grounds that
these elements may appear in an instance document&apos;s
header section, and its nice if they are human
parseable.

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

If I count right that means
rules: Christian(?), Sebastian, Yves
global something: Felix
which means I&apos;m out.
Rules would be o.k. with me, so &lt;its:rules&gt;.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>8905</commentid>
    <comment_count>10</comment_count>
    <who name="Sebastian Rahtz">sebastian.rahtz</who>
    <bug_when>2006-03-27 16:48:53 +0000</bug_when>
    <thetext>&gt; Then maybe using XLink&apos;s simple link would be better: not re-inventing
&gt; &gt; something and keeping it processable by simple tools. I&apos;m not very familiar
&gt; &gt; with XLink but it seems we should be able to do:
&gt; &gt; 
&gt; &gt; &lt;its:link xlink:href=&quot;someRules.xml&quot;/&gt;

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


</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>9080</commentid>
    <comment_count>11</comment_count>
    <who name="Yves Savourel">ysavourel</who>
    <bug_when>2006-04-07 20:06:20 +0000</bug_when>
    <thetext>
Resolutions: &lt;documentRules&gt; is now &lt;rules&gt;
</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>10678</commentid>
    <comment_count>12</comment_count>
    <who name="Felix Sasaki">fsasaki</who>
    <bug_when>2006-07-24 10:30:45 +0000</bug_when>
    <thetext>Closed, no further action necessary.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>