hixie: Explain some of the conformance terminology better. (whatwg r6473)

hixie: Explain some of the conformance terminology better. (whatwg
r6473)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5174&r2=1.5175&f=h
http://html5.org/tools/web-apps-tracker?from=6472&to=6473

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5174
retrieving revision 1.5175
diff -u -d -r1.5174 -r1.5175
--- Overview.html 16 Aug 2011 04:33:26 -0000 1.5174
+++ Overview.html 16 Aug 2011 04:40:46 -0000 1.5175
@@ -2718,6 +2718,27 @@
   key word ("must", "should", "may", etc) used in introducing the
   algorithm.</p>
 
+  <div class="example">
+
+   <p>For example, were the spec to say:</p>
+
+   <pre>To eat a kiwi, the user must:
+1. Peel the kiwi.
+2. Eat the kiwi flesh.</pre>
+
+   <p>...it would be equivalent to the following:</p>
+
+   <pre>To eat a kiwi:
+1. The user must peel the kiwi.
+2. The user must eat the kiwi flesh.</pre>
+
+   <p>Here the key word is "must".</p>
+
+   <p>The former (imperative) style is generally preferred in this
+   specification for stylistic reasons.</p>
+
+  </div>
+
   <p>Conformance requirements phrased as algorithms or specific steps
   may be implemented in any manner, so long as the end result is
   equivalent. (In particular, the algorithms defined in this

Received on Tuesday, 16 August 2011 04:41:06 UTC