[html5] r1614 - /

[whatwg at whatwg.org]

Author: ianh
Date: 2008-05-14 01:18:35 -0700 (Wed, 14 May 2008)
New Revision: 1614

Modified:
   index
   source
Log:
[a] (0) Some introductory comments on scripting for authors.

Modified: index
===================================================================
--- index	2008-05-14 08:02:53 UTC (rev 1613)
+++ index	2008-05-14 08:18:35 UTC (rev 1614)
@@ -22533,6 +22533,27 @@
 
   <h3 id=scripting0><span class=secno>3.15 </span>Scripting</h3>
 
+  <p>Scripts allow authors to add interactivity to their documents.
+
+  <p>Authors are encouraged to use declarative alternatives to scripting
+   where possible, as declarative mechanisms are often more maintainable, and
+   many users disable scripting.
+
+  <div class=example>
+   <p>For example, instead of using script to show or hide a section to show
+    more details, the <code><a href="#details">details</a></code> element
+    could be used.</p>
+  </div>
+
+  <p>Authors are also encouraged to make their applications fail gracefully
+   in the absence of scripting support.
+
+  <div class=example>
+   <p>For example, if an author provides a link in a table header to
+    dynamically resort the table, the link could also be made to function
+    without scripts by requesting the sorted table from the server.</p>
+  </div>
+
   <h4 id=script><span class=secno>3.15.1 </span>The <dfn
    id=script0><code>script</code></dfn> element</h4>
 

Modified: source
===================================================================
--- source	2008-05-14 08:02:53 UTC (rev 1613)
+++ source	2008-05-14 08:18:35 UTC (rev 1614)
@@ -20392,6 +20392,29 @@
 
   <h3>Scripting</h3>
 
+  <p>Scripts allow authors to add interactivity to their documents.</p>
+
+  <p>Authors are encouraged to use declarative alternatives to
+  scripting where possible, as declarative mechanisms are often more
+  maintainable, and many users disable scripting.</p>
+
+  <div class="example">
+   <p>For example, instead of using script to show or hide a section
+   to show more details, the <code>details</code> element could be
+   used.</p>
+  </div>
+
+  <p>Authors are also encouraged to make their applications fail
+  gracefully in the absence of scripting support.</p>
+
+  <div class="example">
+   <p>For example, if an author provides a link in a table header to
+   dynamically resort the table, the link could also be made to
+   function without scripts by requesting the sorted table from the
+   server.</p>
+  </div>
+
+
   <h4 id="script">The <dfn><code>script</code></dfn> element</h4>
 
   <dl class="element">