Bug 25661 - Tweak the wording of conformance requirements language to make it clear that "algorithms" extends to "specific steps",
authorRyan Sleevi <sleevi@google.com>
Mon, 16 Jun 2014 00:00:00 -0700
changeset 184 8db968b4673c
parent 183 a4cb70fcc0bb
child 185 193c854a9ac7
Bug 25661 - Tweak the wording of conformance requirements language to make it clear that "algorithms" extends to "specific steps",
and not just those enumerated in the "algorithms" section (eg: 'parse an SPKI')
spec/Overview-WebCryptoAPI.xml
spec/Overview.html
--- a/spec/Overview-WebCryptoAPI.xml	Mon Jun 16 00:00:00 2014 -0700
+++ b/spec/Overview-WebCryptoAPI.xml	Mon Jun 16 00:00:00 2014 -0700
@@ -306,14 +306,14 @@
               uses both the terms "conforming user agent" and "user agent" to refer to this
               product class.
             </p>
-            <p>
-              User agents <span class='RFC2119'>MAY</span> implement algorithms in this
-              specification in any way desired, so long as the end result is indistinguishable
-              from the result that would be obtained from the specification's algorithms.
-            </p>
           </dd>         
         </dl>
         <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 specification are intended to be easy to follow, and not intended to be performant.)
+        </p>
+        <p>
           User agents that use ECMAScript to implement the APIs defined in this specification
           <span class='RFC2119'>MUST</span> implement them in a manner consistent with the
           ECMAScript Bindings defined in the Web IDL specification [<a href="#WebIDL">WEBIDL</a>]
--- a/spec/Overview.html	Mon Jun 16 00:00:00 2014 -0700
+++ b/spec/Overview.html	Mon Jun 16 00:00:00 2014 -0700
@@ -314,14 +314,14 @@
               uses both the terms "conforming user agent" and "user agent" to refer to this
               product class.
             </p>
-            <p>
-              User agents <span class="RFC2119">MAY</span> implement algorithms in this
-              specification in any way desired, so long as the end result is indistinguishable
-              from the result that would be obtained from the specification's algorithms.
-            </p>
           </dd>         
         </dl>
         <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 specification are intended to be easy to follow, and not intended to be performant.)
+        </p>
+        <p>
           User agents that use ECMAScript to implement the APIs defined in this specification
           <span class="RFC2119">MUST</span> implement them in a manner consistent with the
           ECMAScript Bindings defined in the Web IDL specification [<a href="#WebIDL">WEBIDL</a>]