W3C home > Mailing lists > Public > public-multilingualweb-lt-commits@w3.org > December 2012

CVS WWW/International/multilingualweb/lt/drafts/its20

From: CVS User fsasaki <cvsmail@w3.org>
Date: Mon, 03 Dec 2012 19:15:45 +0000
Message-Id: <E1TfbUX-0004kE-GN@gil.w3.org>
To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv18190

Modified Files:
	its20.html its20.odd 
Log Message:
changes related to annotatorsRef

--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html	2012/12/01 19:44:17	1.295
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html	2012/12/03 19:15:45	1.296
@@ -1237,9 +1237,10 @@
               <a href="#terminology" shape="rect">Terminology</a> data category, providing confidence
             information via the <code class="its-attr-markup">termConfidence</code> attribute.</p><p>ITS 2.0 provides a mechanism to associate such processor information with the use of
             individual data categories in a document, independently from data category annotations
-            themselves.</p><p>The attribute <code class="its-attr-markup">annotatorRef</code> provides a way to associate all the annotations of a
+            themselves.</p><p>The attribute <code class="its-attr-markup">annotatorsRef</code> provides a way to associate all the annotations of a
             given data category within the element with information about the processor that
-            generated those data category annotations.</p><p>The value of <code class="its-attr-markup">annotatorRef</code> is a space-separated list of references where each
+            generated those data category annotations.</p><div class="note"><p class="prefix"><b>Note:</b></p><ul><li><p id="annotators-ref-usage-scenarios">Three cases of providing tool information can be expected:</p><ol class="depth1"><li><p>information about tools used for creating or modifying the textual content;</p></li><li><p>information about tools that do 1), but also create ITS annotations, see <a class="section-ref" href="#list-of-elements-and-attributes" shape="rect">Appendix H: List of ITS 2.0 Global Elements and Local Attributes</a>; </p></li><li><p>information about tools that don’t modify or create content, but just create ITS annotations.</p></li></ol><p>
+                        <code class="its-attr-markup">annotatorsRef</code> is only meant to be used when actual ITS annotation is involved, that is for 2) and 3). To express tool information related only to the creation or modification of textual content and independent of ITS data categories, that is case 1), one should use the tool or <code class="its-attr-markup">toolRef</code> attribute provided by the <a href="#provenance" shape="rect">Provenance</a> data category.</p></li><li><p>An example of case 2) is an MT engine that modifies content and creates ITS <a href="#mtconfidence" shape="rect">MT Confidence</a> annotations. Here the situation may occur that several tools are involved in creating MT Confidence annotations: the MT engine and the tool inserting the markup. The annotatorsRef attribute should identify the tool most useful in further processes, in this case the MT engine.</p></li></ul></div><p>The value of <code class="its-attr-markup">annotatorsRef</code> is a space-separated list of references where each
             reference is composed of two parts: a data category identifier and an IRI. These two
             parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p><ul><li><p>The data category identifier <a href="#rfc2119" shape="rect">MUST</a> be one of the
                 identifiers specified in the <a href="#datacategories-overview" shape="rect">data category
@@ -1248,48 +1249,48 @@
                 indicate processor information. Possible mechanisms are: to encode information
                 directly in the IRI, e.g. as parameters; to reference an external resource that
                 provides such information, e.g. an XML file or an RDF declaration; or to reference
-                another part of the document that provides such information.</p></li></ul><p>In HTML documents, the mechanism is implemented with the <code class="its-attr-markup">its-annotator-ref</code>
+                another part of the document that provides such information.</p></li></ul><p>In HTML documents, the mechanism is implemented with the <code class="its-attr-markup">its-annotators-ref</code>
             attribute.</p><p>The attribute applies to the content of the element where it is declared (including its
             children elements) and to the attributes of that element.</p><p>On any given node, the information provided by this mechanism is a space-separated list
-            of the accumulated references found it the <code class="its-attr-markup">annotatorRef</code> attributes declared in
+            of the accumulated references found it the <code class="its-attr-markup">annotatorsRef</code> attributes declared in
             the enclosing elements and sorted by data category identifiers. For each data category,
-            the IRI part is the one of the inner-most declarartion.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 26: Accumulation and Overriding of the <code class="its-attr-markup">annotatorRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the
+            the IRI part is the one of the inner-most declarartion.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 26: Accumulation and Overriding of the <code class="its-attr-markup">annotatorsRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the
               given node. Note that the references are ordered alphabetically and that the IRI
               values are always the ones of the inner-most declaration.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;doc</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"1.5"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span>
-     <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|MT1"</span><strong class="hl-tag" style="color: #000096">
+     <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|MT1"</span><strong class="hl-tag" style="color: #000096">
   &gt;</strong>doc node: "mt-confidence|MT1"
- <strong class="hl-tag" style="color: #000096">&lt;group</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"lq-issue|ABC"</span><strong class="hl-tag" style="color: #000096">
+ <strong class="hl-tag" style="color: #000096">&lt;group</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"lq-issue|ABC"</span><strong class="hl-tag" style="color: #000096">
   &gt;</strong>group node: "lq-issues|ABC mt-confidence|MT1"
-  <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"disambiguation|Tool3"</span><strong class="hl-tag" style="color: #000096">
+  <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"disambiguation|Tool3"</span><strong class="hl-tag" style="color: #000096">
    &gt;</strong>This p node: "disambiguation|Tool3 lq-issue|ABC mt-confidence|MT1"<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
-  <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|MT123"</span><strong class="hl-tag" style="color: #000096">
+  <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|MT123"</span><strong class="hl-tag" style="color: #000096">
    &gt;</strong>This p node: "disambiguation|Tool3 lq-issue|ABC mt-confidence|MT123"<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
  <strong class="hl-tag" style="color: #000096">&lt;/group&gt;</strong>
- <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"disambiguation|XYZ"</span><strong class="hl-tag" style="color: #000096">
+ <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"disambiguation|XYZ"</span><strong class="hl-tag" style="color: #000096">
   &gt;</strong>This p node: "disambiguation|XYZ mt-confidence|MT1"<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/doc&gt;</strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-1.xml" shape="rect">examples/xml/EX-its-tool-annotation-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-2" id="EX-its-tool-annotation-2" shape="rect"/>Example 27: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">annotatorRef</code> attribute is used in this XML document to indicate that
+</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-1.xml" shape="rect">examples/xml/EX-its-tool-annotation-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-2" id="EX-its-tool-annotation-2" shape="rect"/>Example 27: Example of ITS Tools Annotation</div><p>The <code class="its-attr-markup">annotatorsRef</code> attribute is used in this XML document to indicate that
               information about the processor that generated the <code class="its-attr-markup">mtConfidence</code> values for
               the first two <code>p</code> elements are found in element with <code>id="T1"</code>
               in the external document tools.xml, while that information for the third
                 <code>p</code> element is found in the element with <code>id="T2"</code> in the same
-              document. In addition, <code class="its-attr-markup">annotatorRef</code> is used to identify a Web resource with
+              document. In addition, <code class="its-attr-markup">annotatorsRef</code> is used to identify a Web resource with
               information about the QA tool used to generate the <a href="#lqissue" shape="rect">Localization
                 Quality Issue</a> annotation in the document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;doc</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span>
-    <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1 lq-issue|http://www.qalsp-ex.com/qatools/transcheckv1.3"</span>
+    <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1 lq-issue|http://www.qalsp-ex.com/qatools/transcheckv1.3"</span>
     <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.78"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>Text translated with tool T1<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.55"</span> <span class="hl-attribute" style="color: #F5844C">its:locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"typographical"</span>
         <span class="hl-attribute" style="color: #F5844C">its:locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Sentence without capitalization"</span>
         <span class="hl-attribute" style="color: #F5844C">its:locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"50"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>text also translated with tool T1<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
-    <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.34"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T2"</span><strong class="hl-tag" style="color: #000096">&gt;</strong> Text translated
+    <strong class="hl-tag" style="color: #000096">&lt;p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.34"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T2"</span><strong class="hl-tag" style="color: #000096">&gt;</strong> Text translated
         with tool T2<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/doc&gt;</strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-2.xml" shape="rect">examples/xml/EX-its-tool-annotation-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-html5-1" id="EX-its-tool-annotation-html5-1" shape="rect"/>Example 28: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">its-annotator-ref</code> attributes are used in this HTML document to indicate
+</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-2.xml" shape="rect">examples/xml/EX-its-tool-annotation-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-html5-1" id="EX-its-tool-annotation-html5-1" shape="rect"/>Example 28: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">its-annotators-ref</code> attributes are used in this HTML document to indicate
               that the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation on the first two
                 <code>span</code> elements come from one MT (French to English) engine, while the
               annotation on the third comes from another (Italian to English) engine. Both
-                <code class="its-attr-markup">its-annotator-ref</code> attributes refer to a Web resource for information about
+                <code class="its-attr-markup">its-annotators-ref</code> attributes refer to a Web resource for information about
               the engine generating the <a href="#mtconfidence" shape="rect">MT Confidence</a>
               annotation.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;head&gt;</strong>
@@ -1298,12 +1299,12 @@
                 machine translated into english with mtConfidence defined 
                 locally.<strong class="hl-tag" style="color: #000096">&lt;/title&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/head&gt;</strong>
-    <strong class="hl-tag" style="color: #000096">&lt;body</strong> <span class="hl-attribute" style="color: #F5844C">its-annotator-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|http://www.exmt-prov.com/2012/11/9/fr-t-en"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+    <strong class="hl-tag" style="color: #000096">&lt;body</strong> <span class="hl-attribute" style="color: #F5844C">its-annotators-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|http://www.exmt-prov.com/2012/11/9/fr-t-en"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
         <strong class="hl-tag" style="color: #000096">&lt;p&gt;</strong>     
             <strong class="hl-tag" style="color: #000096">&lt;span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.8982</span><strong class="hl-tag" style="color: #000096">&gt;</strong>Dublin is the capital of Ireland.<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong>
             <strong class="hl-tag" style="color: #000096">&lt;span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.8536</span><strong class="hl-tag" style="color: #000096">&gt;</strong>The capital of the Czech Republic is Prague.<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong>
             <strong class="hl-tag" style="color: #000096">&lt;span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.7009</span>
-                <span class="hl-attribute" style="color: #F5844C">its-annotator-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|http://www.exmt-prov.com/2012/11/9/it-t-en"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>The capital Italia is Roma.<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong>
+                <span class="hl-attribute" style="color: #F5844C">its-annotators-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|http://www.exmt-prov.com/2012/11/9/it-t-en"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>The capital Italia is Roma.<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong>
         <strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>  
     <strong class="hl-tag" style="color: #000096">&lt;/body&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/html&gt;</strong>
@@ -1738,9 +1739,9 @@
                 provided, <code class="its-attr-markup">termInfoRef</code>, are accurate. 1 represents the highest level of
                 confidence.</p></li></ul><p>Any node selected by the terminology data category with the <code class="its-attr-markup">termConfidence</code>
               attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with
-              the <code class="its-attr-markup">annotatorRef</code> (or in HTML <code class="its-attr-markup">its-annotator-ref</code>) attribute specified for
+              the <code class="its-attr-markup">annotatorsRef</code> (or in HTML <code class="its-attr-markup">its-annotators-ref</code>) attribute specified for
               the <a href="#terminology" shape="rect">Terminology</a> data category. See <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a> for more information.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-terms-selector-4" id="EX-terms-selector-4" shape="rect"/>Example 43: The <a href="#terminology" shape="rect">Terminology</a> data category expressed
-                locally, including term information reference and confidence score.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;book</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"terminology|http://example.com/term-tool"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+                locally, including term information reference and confidence score.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;book</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"terminology|http://example.com/term-tool"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;head&gt;</strong>...<strong class="hl-tag" style="color: #000096">&lt;/head&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;body&gt;</strong>
     ... 
@@ -2134,11 +2135,11 @@
                             source.</p></li></ul></li><li><p>When using the addressing <a href="#disambiguation-use-cases" shape="rect">mode 2</a>:</p><ul><li><p>A <code class="its-attr-markup">disambigIdentRef</code> attribute that contains an IRI that
                               represents a unique identifier for the disambiguation
                             target.</p></li></ul></li></ul></li></ul></li></ul><p>Any node selected by the <a href="#Disambiguation" shape="rect">disambiguation</a> data
-              category with the <code class="its-attr-markup">disambigConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code class="its-attr-markup">annotatorRef</code>
-              (or in HTML <code class="its-attr-markup">its-annotator-ref</code>) attribute specified for the <a href="#Disambiguation" shape="rect">disambiguation</a> data category. For more information,
+              category with the <code class="its-attr-markup">disambigConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code class="its-attr-markup">annotatorsRef</code>
+              (or in HTML <code class="its-attr-markup">its-annotators-ref</code>) attribute specified for the <a href="#Disambiguation" shape="rect">disambiguation</a> data category. For more information,
               see <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 57: Local mixed usage of Usage of <code class="its-attr-markup">disambigClassRef</code>,
                   <code class="its-attr-markup">disambigGranularity</code>, and <code class="its-attr-markup">disambigIdentRef</code> in HTML.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue">&lt;!DOCTYPE html&gt;</strong>
-<strong class="hl-tag" style="color: #000096">&lt;html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">"en"</span> <span class="hl-attribute" style="color: #F5844C">its-annotator-ref</span>=<span class="hl-value" style="color: #993300">"disambiguation|http://enrycher.ijs.si"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+<strong class="hl-tag" style="color: #000096">&lt;html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">"en"</span> <span class="hl-attribute" style="color: #F5844C">its-annotators-ref</span>=<span class="hl-value" style="color: #993300">"disambiguation|http://enrycher.ijs.si"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;head&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;meta</strong> <span class="hl-attribute" style="color: #F5844C">charset</span>=<span class="hl-value" style="color: #993300">"utf-8"</span><strong class="hl-tag" style="color: #000096"> /&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;title&gt;</strong>Disambiguation: Local Test<strong class="hl-tag" style="color: #000096">&lt;/title&gt;</strong>
@@ -2260,7 +2261,7 @@
               translated documents.</p><p>The data category defines seven pieces of information:</p><a name="provenanceDefs" id="provenanceDefs" shape="rect"/><table border="1"><thead><tr><td rowspan="1" colspan="1">Information</td><td rowspan="1" colspan="1">Description</td><td rowspan="1" colspan="1">Value</td></tr></thead><tbody><tr><td rowspan="1" colspan="1">Human provenance information</td><td rowspan="1" colspan="1">Identification of a human translation agent</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Organisational provenance information</td><td rowspan="1" colspan="1">Identification of an organization acting as a translation agent</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Tool related provenance information</td><td rowspan="1" colspan="1">Identification of a software tool that was used in translating the selected
                   content</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Human revision provenance information</td><td rowspan="1" colspan="1">Identification of a human translation revision agent</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Organisational revision provenance information</td><td rowspan="1" colspan="1">Identification of an organization acting as a translation revision
                   agent</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Tool related revision provenance information</td><td rowspan="1" colspan="1">Identification of a software tool that was used in revising the translation of
-                  the selected content</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Reference to external provenance information</td><td rowspan="1" colspan="1">A reference to external provenance information</td><td rowspan="1" colspan="1">A space (U+0020) separated list of IRIs</td></tr></tbody></table></div><div class="div3">
+                  the selected content</td><td rowspan="1" colspan="1">A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td rowspan="1" colspan="1">Reference to external provenance information</td><td rowspan="1" colspan="1">A reference to external provenance information</td><td rowspan="1" colspan="1">A space (U+0020) separated list of IRIs</td></tr></tbody></table><div class="note"><p class="prefix"><b>Note:</b></p><p>The tool related provenance and tool related revision provenance pieces of information are not meant to express information about tools used for creating ITS annotations themselves. For this purpose, ITS 2.0 provides a separate mechanism. See <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a> for details, especially the <a href="#annotators-ref-usage-scenarios" shape="rect">note on annotatorsRef usage scenarios</a>.</p></div></div><div class="div3">
 <h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="provenance-implementation" id="provenance-implementation" shape="rect"/>8.12.2 Implementation</h4><p>The <a href="#provenance" shape="rect">Provenance</a> data category can be expressed with
               global rules, or locally on individual elements. For elements, the data category
               information <a href="#def-inheritance" shape="rect">inherits</a> to the textual content of
@@ -2948,7 +2949,7 @@
               of the element, <em>including</em> child elements, but <em>excluding</em>
               attributes.</p><p>Any node selected by the <a href="#mtconfidence" shape="rect">MT Confidence</a> data
               category <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the
-                <code class="its-attr-markup">annotatorRef</code> (or in HTML, <code class="its-attr-markup">its-annotator-ref</code>) attribute specified for
+                <code class="its-attr-markup">annotatorsRef</code> (or in HTML, <code class="its-attr-markup">its-annotators-ref</code>) attribute specified for
               the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category. For more
               information, see <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a>.</p><p id="mtconfidence-global">GLOBAL: The <code class="its-elem-markup">mtConfidenceRule</code> element contains
               the following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which
@@ -2965,7 +2966,7 @@
    <strong class="hl-tag" style="color: #000096">&lt;title&gt;</strong>Machine translated title attributes of img elements give MT 
            confidence scores using global rules<strong class="hl-tag" style="color: #000096">&lt;/title&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/head&gt;</strong>
-  <strong class="hl-tag" style="color: #000096">&lt;body</strong> <span class="hl-attribute" style="color: #F5844C">its-annotator-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+  <strong class="hl-tag" style="color: #000096">&lt;body</strong> <span class="hl-attribute" style="color: #F5844C">its-annotators-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
    <strong class="hl-tag" style="color: #000096">&lt;p&gt;</strong>     
     <strong class="hl-tag" style="color: #000096">&lt;img</strong> <span class="hl-attribute" style="color: #F5844C">src</span>=<span class="hl-value" style="color: #993300">"http://upload.wikimedia.org/wikipedia/commons/9/93/Trinity_College.jpg"</span> 
                <span class="hl-attribute" style="color: #F5844C">title</span>=<span class="hl-value" style="color: #993300">"Front gate of Trinity College Dublin"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
@@ -2985,7 +2986,7 @@
                   translation confidence score as a rational number in the interval 0 to 1
                   (inclusive). The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema
                     decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-mtConfidence-local-1" id="EX-mtConfidence-local-1" shape="rect"/>Example 86: The <a href="#mtconfidence" shape="rect">MT Confidence</a> data category expressed
-                locally for the content of a span in an XML document.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;text</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+                locally for the content of a span in an XML document.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;text</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;body&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;p&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;span</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.8982"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>Dublin is the capital city of
@@ -3000,7 +3001,7 @@
       <strong class="hl-tag" style="color: #000096">&lt;title&gt;</strong>Sentences about Dublin and Prague 
          machine translated from Czech with mtConfidence locally.<strong class="hl-tag" style="color: #000096">&lt;/title&gt;</strong>
    <strong class="hl-tag" style="color: #000096">&lt;/head&gt;</strong>
-    <strong class="hl-tag" style="color: #000096">&lt;body</strong> <span class="hl-attribute" style="color: #F5844C">its-annotator-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+    <strong class="hl-tag" style="color: #000096">&lt;body</strong> <span class="hl-attribute" style="color: #F5844C">its-annotators-ref</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T1"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
        <strong class="hl-tag" style="color: #000096">&lt;p&gt;</strong>     
          <strong class="hl-tag" style="color: #000096">&lt;span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.8982</span><strong class="hl-tag" style="color: #000096">&gt;</strong>Dublin is the capital of Ireland.<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong>
          <strong class="hl-tag" style="color: #000096">&lt;span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.8536</span><strong class="hl-tag" style="color: #000096"> &gt;</strong>The capital of the Czech Republic is Prague.<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong>
@@ -3984,14 +3985,14 @@
       <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-lineBreakType.type"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/attribute&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
-  <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorRef"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
-    <strong class="hl-tag" style="color: #000096">&lt;attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its:annotatorRef"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
-      <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-annotatorRef.type"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
+  <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorsRef"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+    <strong class="hl-tag" style="color: #000096">&lt;attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its:annotatorsRef"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+      <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-annotatorsRef.type"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/attribute&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
-  <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorRef.nons"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
-    <strong class="hl-tag" style="color: #000096">&lt;attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"annotatorRef"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
-      <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-annotatorRef.type"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
+  <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorsRef.nons"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+    <strong class="hl-tag" style="color: #000096">&lt;attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"annotatorsRef"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+      <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-annotatorsRef.type"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/attribute&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.version"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
@@ -4243,7 +4244,7 @@
         <strong class="hl-tag" style="color: #000096">&lt;/optional&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;/optional&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;optional&gt;</strong>
-        <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorRef"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
+        <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorsRef"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;/optional&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/interleave&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
@@ -4398,7 +4399,7 @@
         <strong class="hl-tag" style="color: #000096">&lt;/optional&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;/optional&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;optional&gt;</strong>
-        <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorRef.nons"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
+        <strong class="hl-tag" style="color: #000096">&lt;ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.annotatorsRef.nons"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
       <strong class="hl-tag" style="color: #000096">&lt;/optional&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/interleave&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
@@ -5396,7 +5397,7 @@
       <strong class="hl-tag" style="color: #000096">&lt;value&gt;</strong>nel<strong class="hl-tag" style="color: #000096">&lt;/value&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;/choice&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
-  <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-annotatorRef.type"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+  <strong class="hl-tag" style="color: #000096">&lt;define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-annotatorsRef.type"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"string"</span> <span class="hl-attribute" style="color: #F5844C">datatypeLibrary</span>=<span class="hl-value" style="color: #993300">""</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/define&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/grammar&gt;</strong>
@@ -5562,7 +5563,7 @@
 &lt;/html&gt;</span></pre></div></div><p>Case 3: The NLP annotation created in NIF starts in one region and ends in another.
           Solution: No straight mapping is possible; a mapping can be created if both regions have
           the same parent.</p></div><div class="div1">
-<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="list-of-elements-and-attributes" id="list-of-elements-and-attributes" shape="rect"/>H List of ITS 2.0 Global Elements and Local Attributes (Non-Normative)</h2><p>The following table lists global ITS 2.0 elements inside <code class="its-elem-markup">rules</code> element and local ITS 2.0 markup in XML and HTML. Note that for the local markup there are various constraints on what local attributes should be used together. Here these constraints are expressed via occurrence indicators: optional "?",  alternatives "|", or groups "(...)". Please check the related sub sections in <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a> defining local markup normatively.</p><p>In addition to below markup, ITS 2.0 provides a means to refer to the tools used to generate the markup: for XML the <code class="its-attr-markup">annotatorRef</code> attribute and for HTML the <code class="its-attr-markup">annotator-Ref</code> attribute. See <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a> for details.</p><table border="1"><thead><tr><td rowspan="1" colspan="1">Data category</td><td rowspan="1" colspan="1">Global element inside <code class="its-elem-markup">rules</code> element</td><td rowspan="1" colspan="1">Local XML attributes in ITS namespace</td><td rowspan="1" colspan="1">HTML attributes</td></tr></thead><tbody><tr><td rowspan="1" colspan="1">
+<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="list-of-elements-and-attributes" id="list-of-elements-and-attributes" shape="rect"/>H List of ITS 2.0 Global Elements and Local Attributes (Non-Normative)</h2><p>The following table lists global ITS 2.0 elements inside <code class="its-elem-markup">rules</code> element and local ITS 2.0 markup in XML and HTML. Note that for the local markup there are various constraints on what local attributes should be used together. Here these constraints are expressed via occurrence indicators: optional "?",  alternatives "|", or groups "(...)". Please check the related sub sections in <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a> defining local markup normatively.</p><p>In addition to below markup, ITS 2.0 provides a means to refer to the tools used to generate the markup: for XML the <code class="its-attr-markup">annotatorsRef</code> attribute and for HTML the <code class="its-attr-markup">annotators-ref</code> attribute. See <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a> for details, especially the <a href="#annotators-ref-usage-scenarios" shape="rect">note on annotatorsRef usage scenarios</a>.</p><table border="1"><thead><tr><td rowspan="1" colspan="1">Data category</td><td rowspan="1" colspan="1">Global element inside <code class="its-elem-markup">rules</code> element</td><td rowspan="1" colspan="1">Local XML attributes in ITS namespace</td><td rowspan="1" colspan="1">HTML attributes</td></tr></thead><tbody><tr><td rowspan="1" colspan="1">
                      <a href="#trans-datacat" shape="rect">Translate</a>
                   </td><td rowspan="1" colspan="1">
                      <code class="its-elem-markup">translateRule</code>
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd	2012/12/01 19:44:17	1.295
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd	2012/12/03 19:15:45	1.296
@@ -1743,11 +1743,21 @@
             individual data categories in a document, independently from data category annotations
             themselves.</p>
 
-          <p>The attribute <att>annotatorRef</att> provides a way to associate all the annotations of a
+          <p>The attribute <att>annotatorsRef</att> provides a way to associate all the annotations of a
             given data category within the element with information about the processor that
             generated those data category annotations.</p>
+          
+          <note><list>
+            <item><p xml:id="annotators-ref-usage-scenarios">Three cases of providing tool information can be expected:</p>
+              <list type="ordered">
+                <item><p>information about tools used for creating or modifying the textual content;</p></item>
+                <item><p>information about tools that do 1), but also create ITS annotations, see <ptr target="#list-of-elements-and-attributes" type="specref"/>; </p></item>
+                <item><p>information about tools that don’t modify or create content, but just create ITS annotations.</p></item> </list><p><att>annotatorsRef</att> is only meant to be used when actual ITS annotation is involved, that is for 2) and 3). To express tool information related only to the creation or modification of textual content and independent of ITS data categories, that is case 1), one should use the tool or <att>toolRef</att> attribute provided by the <ref target="#provenance">Provenance</ref> data category.</p></item>
+            <item><p>An example of case 2) is an MT engine that modifies content and creates ITS <ref target="#mtconfidence">MT Confidence</ref> annotations. Here the situation may occur that several tools are involved in creating MT Confidence annotations: the MT engine and the tool inserting the markup. The annotatorsRef attribute should identify the tool most useful in further processes, in this case the MT engine.</p></item>
+            
+          </list></note>
 
-          <p>The value of <att>annotatorRef</att> is a space-separated list of references where each
+          <p>The value of <att>annotatorsRef</att> is a space-separated list of references where each
             reference is composed of two parts: a data category identifier and an IRI. These two
             parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p>
 
@@ -1763,19 +1773,19 @@
                 another part of the document that provides such information.</p></item>
           </list>
 
-          <p>In HTML documents, the mechanism is implemented with the <att>its-annotator-ref</att>
+          <p>In HTML documents, the mechanism is implemented with the <att>its-annotators-ref</att>
             attribute.</p>
 
           <p>The attribute applies to the content of the element where it is declared (including its
             children elements) and to the attributes of that element.</p>
 
           <p>On any given node, the information provided by this mechanism is a space-separated list
-            of the accumulated references found it the <att>annotatorRef</att> attributes declared in
+            of the accumulated references found it the <att>annotatorsRef</att> attributes declared in
             the enclosing elements and sorted by data category identifiers. For each data category,
             the IRI part is the one of the inner-most declarartion.</p>
 
           <exemplum xml:id="EX-its-tool-annotation-1">
-            <head>Accumulation and Overriding of the <att>annotatorRef</att> Values</head>
+            <head>Accumulation and Overriding of the <att>annotatorsRef</att> Values</head>
             <p>In this example, the text shows the computed tools reference information for the
               given node. Note that the references are ordered alphabetically and that the IRI
               values are always the ones of the inner-most declaration.</p>
@@ -1784,13 +1794,13 @@
           </exemplum>
 
           <exemplum xml:id="EX-its-tool-annotation-2">
-            <head>Example of ITS Tool Annotation</head>
-            <p>The <att>annotatorRef</att> attribute is used in this XML document to indicate that
+            <head>Example of ITS Tools Annotation</head>
+            <p>The <att>annotatorsRef</att> attribute is used in this XML document to indicate that
               information about the processor that generated the <att>mtConfidence</att> values for
               the first two <code>p</code> elements are found in element with <code>id="T1"</code>
               in the external document tools.xml, while that information for the third
                 <code>p</code> element is found in the element with <code>id="T2"</code> in the same
-              document. In addition, <att>annotatorRef</att> is used to identify a Web resource with
+              document. In addition, <att>annotatorsRef</att> is used to identify a Web resource with
               information about the QA tool used to generate the <ref target="#lqissue">Localization
                 Quality Issue</ref> annotation in the document.</p>
             <egXML xmlns="http://www.tei-c.org/ns/Examples"
@@ -1798,11 +1808,11 @@
           </exemplum>
           <exemplum xml:id="EX-its-tool-annotation-html5-1">
             <head>Example of ITS Tool Annotation</head>
-            <p>The <att>its-annotator-ref</att> attributes are used in this HTML document to indicate
+            <p>The <att>its-annotators-ref</att> attributes are used in this HTML document to indicate
               that the <ref target="#mtconfidence">MT Confidence</ref> annotation on the first two
                 <code>span</code> elements come from one MT (French to English) engine, while the
               annotation on the third comes from another (Italian to English) engine. Both
-                <att>its-annotator-ref</att> attributes refer to a Web resource for information about
+                <att>its-annotators-ref</att> attributes refer to a Web resource for information about
               the engine generating the <ref target="#mtconfidence">MT Confidence</ref>
               annotation.</p>
             <egXML xmlns="http://www.tei-c.org/ns/Examples"
@@ -2582,7 +2592,7 @@
             </list>
             <p>Any node selected by the terminology data category with the <att>termConfidence</att>
               attribute specified <ref target="#rfc2119">MUST</ref> be contained in an element with
-              the <att>annotatorRef</att> (or in HTML <att>its-annotator-ref</att>) attribute specified for
+              the <att>annotatorsRef</att> (or in HTML <att>its-annotators-ref</att>) attribute specified for
               the <ref target="#terminology">Terminology</ref> data category. See <ptr
                 target="#its-tool-annotation" type="specref"/> for more information.</p>
             <exemplum xml:id="EX-terms-selector-4">
@@ -3269,8 +3279,8 @@
             </list>
             <p>Any node selected by the <ref target="#Disambiguation">disambiguation</ref> data
               category with the <att>disambigConfidence</att> attribute specified <ref
-                target="#rfc2119">MUST</ref> be contained in an element with the <att>annotatorRef</att>
-              (or in HTML <att>its-annotator-ref</att>) attribute specified for the <ref
+                target="#rfc2119">MUST</ref> be contained in an element with the <att>annotatorsRef</att>
+              (or in HTML <att>its-annotators-ref</att>) attribute specified for the <ref
                 target="#Disambiguation">disambiguation</ref> data category. For more information,
               see <ptr target="#its-tool-annotation" type="specref"/>.</p>
             <exemplum xml:id="EX-disambiguation-html5-local-1">
@@ -3455,6 +3465,8 @@
                 <cell>A space (U+0020) separated list of IRIs</cell>
               </row>
             </table>
+            <note><p>The tool related provenance and tool related revision provenance pieces of information are not meant to express information about tools used for creating ITS annotations themselves. For this purpose, ITS 2.0 provides a separate mechanism. See <ptr target="#its-tool-annotation" type="specref"/> for details, especially the <ref target="#annotators-ref-usage-scenarios">note on annotatorsRef usage scenarios</ref>.</p></note>
+            
           </div>
           <div xml:id="provenance-implementation">
             <head>Implementation</head>
@@ -4259,7 +4271,7 @@
               attributes.</p>
             <p>Any node selected by the <ref target="#mtconfidence">MT Confidence</ref> data
               category <ref target="#rfc2119">MUST</ref> be contained in an element with the
-                <att>annotatorRef</att> (or in HTML, <att>its-annotator-ref</att>) attribute specified for
+                <att>annotatorsRef</att> (or in HTML, <att>its-annotators-ref</att>) attribute specified for
               the <ref target="#mtconfidence">MT Confidence</ref> data category. For more
               information, see <ptr target="#its-tool-annotation" type="specref"/>.</p>
             <p xml:id="mtconfidence-global">GLOBAL: The <gi>mtConfidenceRule</gi> element contains
@@ -5416,7 +5428,7 @@
       <div xml:id="list-of-elements-and-attributes" type="inform">
         <head>List of ITS 2.0 Global Elements and Local Attributes</head>
         <p>The following table lists global ITS 2.0 elements inside <gi>rules</gi> element and local ITS 2.0 markup in XML and HTML. Note that for the local markup there are various constraints on what local attributes should be used together. Here these constraints are expressed via occurrence indicators: optional <val>?</val>,  alternatives <val>|</val>, or groups <val>(...)</val>. Please check the related sub sections in <ptr target="#datacategory-description" type="specref"/> defining local markup normatively.</p>
-        <p>In addition to below markup, ITS 2.0 provides a means to refer to the tools used to generate the markup: for XML the <att>annotatorRef</att> attribute and for HTML the <att>annotator-Ref</att> attribute. See <ptr target="#its-tool-annotation" type="specref"/> for details.</p>
+        <p>In addition to below markup, ITS 2.0 provides a means to refer to the tools used to generate the markup: for XML the <att>annotatorsRef</att> attribute and for HTML the <att>annotators-ref</att> attribute. See <ptr target="#its-tool-annotation" type="specref"/> for details, especially the <ref target="#annotators-ref-usage-scenarios">note on annotatorsRef usage scenarios</ref>.</p>
         <table border="1">
           <row role="head">
             <cell>Data category</cell>
Received on Monday, 3 December 2012 19:17:59 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 3 December 2012 19:17:59 GMT