[a] (0) data-* attributes and JS libraries: some advice

Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=8208

git-svn-id: http://svn.whatwg.org/webapps@4462 340c8d12-0b0e-0410-8428-c7bf67bfef74

complete.html

@@ -8324,6 +8324,19 @@ <h5 id=embedding-custom-non-visible-data><span class=secno>3.2.3.8 </span><dfn>E
 
   </div>
 
+  <p>JavaScript libraries may use the <span>custom data
+  attributes</span>, as they are considered to be part of the page on
+  which they are used. Authors of libraries that are reused by many
+  authors are encouraged to include their name in the attribute names,
+  to reduce the risk of clashes.</p>
+
+  <div class=example>
+
+   <p>For example, a library called "DoQuery" could use attribute
+   names like <code title="">data-doquery-range</code>, and a library
+   called "jJo" could use attributes names like <code title="">data-jjo-range</code>.</p>
+
+  </div>
 
 
   <h4 id=element-definitions><span class=secno>3.2.4 </span>Element definitions</h4>

index

@@ -8159,6 +8159,19 @@ background: transparent"&gt;blue&lt;/span&gt;.&lt;/p&gt;</pre>
 
   </div>
 
+  <p>JavaScript libraries may use the <span>custom data
+  attributes</span>, as they are considered to be part of the page on
+  which they are used. Authors of libraries that are reused by many
+  authors are encouraged to include their name in the attribute names,
+  to reduce the risk of clashes.</p>
+
+  <div class=example>
+
+   <p>For example, a library called "DoQuery" could use attribute
+   names like <code title="">data-doquery-range</code>, and a library
+   called "jJo" could use attributes names like <code title="">data-jjo-range</code>.</p>
+
+  </div>
 
 
   <h4 id=element-definitions><span class=secno>3.2.4 </span>Element definitions</h4>

source

@@ -8297,6 +8297,20 @@ background: transparent">blue&lt;/span>.&lt;/p></pre>
 
   </div>
 
+  <p>JavaScript libraries may use the <span>custom data
+  attributes</span>, as they are considered to be part of the page on
+  which they are used. Authors of libraries that are reused by many
+  authors are encouraged to include their name in the attribute names,
+  to reduce the risk of clashes.</p>
+
+  <div class="example">
+
+   <p>For example, a library called "DoQuery" could use attribute
+   names like <code title="">data-doquery-range</code>, and a library
+   called "jJo" could use attributes names like <code
+   title="">data-jjo-range</code>.</p>
+
+  </div>
 
 
   <h4>Element definitions</h4>