clarifying hasFeature requirements
authorJames Craig <jcraig@apple.com>
Wed, 10 Jul 2013 16:34:20 -0700
changeset 119 a6e4826cd246
parent 118 0edb411cd753
child 120 10e0d452f2e1
clarifying hasFeature requirements
src/indie-ui-events.html
--- a/src/indie-ui-events.html	Wed Jul 10 00:13:38 2013 -0700
+++ b/src/indie-ui-events.html	Wed Jul 10 16:34:20 2013 -0700
@@ -736,12 +736,14 @@
 		</section>
 		<!-- :::::::::::::::::::: END UI Request Event Interfaces :::::::::::::::::::: -->
 
-		<!-- :::::::::::::::::::: DOMImplementation::hasFeature :::::::::::::::::::: -->
+		<!-- :::::::::::::::::::: DOMImplementation.hasFeature :::::::::::::::::::: -->
 		<section id="hasFeature" class="normative">
 			<h2>Strings for DOMImplementation.hasFeature()</h2>
-			<p>Support for IndieUI Events 1.0 can be queried by calling the <code>DOMImplementation.hasFeature()</code> method with the test string <code>org.w3c.indieui.events</code> and version <code>1.0</code>. Support for specific events can be queried by appending a single period and the literal event name to the feature string, as in <code>org.w3c.indieui.events.valuechangerequest</code>.</p>
+			<p>User agents with <em>complete</em> support for IndieUI Events 1.0 MUST return <code>true</code> when the <code>DOMImplementation.hasFeature()</code> method is called with the feature string <code>"org.w3c.indieui.events"</code> and version <code>"1.0"</code>. User agents with partial-but-incomplete support for Indie UI 1.0 MAY return <code>true</code> when queried with the version string <code>"0.0"</code>.</p>
+			<p class="ednote">The previous RFC-2119 "may" is intended to prevent UAs from claiming full support too soon. Should we use 0.0, 0.9, or something else here? UAs should probably not return true for <code>DOMImplementation.hasFeature("org.w3c.indieui.events", "1.0")</code> until after we publish a Last Call draft.</p>
+			<p>User agents implementing specific events MUST return <code>true</code> when the <code>DOMImplementation.hasFeature()</code> method is called with a feature string matching the literal event name appended to the main IndieUI events string, such as <code>"org.w3c.indieui.events.valuechangerequest"</code>.</p>
 		</section>
-		<!-- :::::::::::::::::::: END DOMImplementation::hasFeature :::::::::::::::::::: -->
+		<!-- :::::::::::::::::::: END DOMImplementation.hasFeature :::::::::::::::::::: -->
 
 		<!--
 		ReSpec: Use @data-transform to reuse a JavaScript content formatter, and @data-oninclude to transform external content before inclusion.