WWW/2011/tracking-protection/drafts tracking-dnt.html,1.152,1.153

Update of /w3ccvs/WWW/2011/tracking-protection/drafts
In directory hutz:/tmp/cvs-serv11481

Modified Files:
	tracking-dnt.html 
Log Message:
ISSUE-84 and ISSUE-116: Update the text describing the DOM attribute to
clarify that it only describes the general, non-exceptioned preference.

(editorial) Remove WebIDL section headers.
(editorial) Transition to simpler/modern form of WebIDL partial interfaces.


Index: tracking-dnt.html
===================================================================
RCS file: /w3ccvs/WWW/2011/tracking-protection/drafts/tracking-dnt.html,v
retrieving revision 1.152
retrieving revision 1.153
diff -u -d -r1.152 -r1.153
--- tracking-dnt.html	14 Aug 2012 03:52:06 -0000	1.152
+++ tracking-dnt.html	14 Aug 2012 08:54:25 -0000	1.153
@@ -24,6 +24,7 @@
       wgPublicList: "public-tracking",
       wgPatentURI: "http://www.w3.org/2004/01/pp-impl/49311/status",
       issueBase:   "http://www.w3.org/2011/tracking-protection/track/issues/",
+      noIDLSectionTitle: true,
     };
   </script>
   <link rel="stylesheet" href="additional.css" type="text/css" media="screen" title="custom formatting for TPWG editors" charset="utf-8">
@@ -409,53 +410,47 @@
       <section id='js-dom'>
         <h3>JavaScript API to Detect Preference</h3>
 
-        <section id='js-interface'>
-          <h4>Interface</h4>
-          <p>
-            The <a>NavigatorDoNotTrack</a> interface provides a means for
-            the user's tracking preference to be expressed to
-            web applications running within a page rendered by the user agent.
-          </p>
-        </section>
-
-        <dl class="idl" title='[NoInterfaceObject] interface NavigatorDoNotTrack'>
+        <p>
+          A <a>doNotTrack</a> attribute on the <code>Navigator</code>
+          interface [[!NAVIGATOR]] (e.g., the <code>window.navigator</code>
+          object) is hereby defined as the means for expressing the user's
+          general tracking preference to scripts running within a top-level
+          page. A user agent MUST provide a <code>doNotTrack</code> attribute
+          on the <code>Navigator</code> interface for each top-level page.
+        </p>
+        <dl class="idl" title='partial interface Navigator {
+                                 readonly attribute DOMString doNotTrack;
+                               };'>
           <dt>readonly attribute DOMString doNotTrack</dt>
           <dd>
-            When a tracking preference is <a>enabled</a>, the doNotTrack
-            attribute MUST have a string value that is the same as the
-            <a>DNT-field-value</a> defined in <a href="#dnt-header-field"
-            class="sectionRef"></a> sent to the origin of the corresponding
-            top-level document. If a tracking preference is <a>not
-            enabled</a>, the value is <code>null</code>.
+            When a tracking preference is <a>enabled</a>, the
+            <code>doNotTrack</code> attribute for each top-level page MUST
+            have the same string value that would be sent in a
+            <a>DNT-field-value</a> (<a href="#dnt-header-field"
+            class="sectionRef"></a>) to an origin server that does not have
+            any corresponding user-granted exceptions.
+            When a tracking preference is <a>not enabled</a>, the
+            <code>doNotTrack</code> attribute for each top-level page MUST
+            have a value of <code>null</code>.
           </dd>
         </dl>
-
-        <section id='js-implements'>
-          <h4>Implements</h4>
-          <div class="idl" title='Navigator implements NavigatorDoNotTrack'>
-             <p>
-               Objects implementing the <code>Navigator</code> interface
-               [[!NAVIGATOR]] (e.g., the <code>window.navigator</code> object)
-               MUST also implement the <code>NavigatorDoNotTrack</code></a>
-               interface. An instance of <code>NavigatorDoNotTrack</code> is
-               obtained by using binding-specific casting methods on an
-               instance of <code>Navigator</code>.
-             </p>
-             <p>
-               The value of the <code>doNotTrack</code> attribute SHOULD be
-               considered guidance and MUST NOT be interpreted as a guarantee
-               of the value of the DNT header sent on future requests. A
-               user's tracking preference may change and may differ for
-               different origins. Servers MUST rely on the DNT header received
-               in a request even if it differs from what a script previously
-               observed in the <code>doNotTrack</code> attribute. Trackers
-               that commonly expect to receive a user-granted exception (as
-               described in <a href="#exceptions" class="sectionRef"></a>)
-               SHOULD assess the user's preference in the HTTP request loading
-               that script.
-             </p>
-          </div>
-        </section>
+        <p>
+          The <code>doNotTrack</code> attribute only provides the user's
+          general tracking preference, independent of any user-granted
+          exceptions or out-of-band consent.  A script wishing to determine
+          the specific tracking preference for a given document origin is
+          expected to use the API in <a href="#exceptions-enquiry"
+          class="sectionRef"></a>.
+        </p>
+        <p>
+          A user agent MUST provide a <code>doNotTrack</code> attribute
+          value that is consistent with the user's current tracking
+          preference that would be expressed via the DNT header field.
+          However, changes to the user's preference might occur between
+          the time when the APIs are checked and an actual request is made.
+          A server MUST treat the user's most recently received preference as
+          authoritative.
+        </p>
         <p class="issue" data-number="84" title="Make DNT status available to JavaScript">
           <strong>[PENDING REVIEW]</strong>
           Updated text in this section.

Received on Tuesday, 14 August 2012 08:54:30 UTC