- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 16 Aug 2011 04:40:50 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv31143
Modified Files:
Overview.html
Log Message:
Explain some of the conformance terminology better. (whatwg r6473)
Index: Overview.html
===================================================================
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:40:54 UTC