More feedback from Jeni.
authorGregg Kellogg <gregg@kellogg-assoc.com>
Thu, 17 Nov 2011 21:58:52 -0800
changeset 32 9eccf2ad2f54
parent 31 337fc1ad6526
child 33 0a53099a2b11
More feedback from Jeni.
microdata-rdf/index.html
--- a/microdata-rdf/index.html	Thu Nov 17 17:48:58 2011 -0800
+++ b/microdata-rdf/index.html	Thu Nov 17 21:58:52 2011 -0800
@@ -270,7 +270,7 @@
       within a <tref>registry</tref> or on an implementation-defined basis. However, the HTML Data TF recommends the
       adoption of a single method of mapping in which every vocabulary is treated as if:</p>
     <ul>
-      <li><tref><code>propertyURI</code></tref> is set to <code>base</code> </li>
+      <li><tref><code>propertyURI</code></tref> is set to <code>vocabulary</code> </li>
       <li><tref><code>multipleValues</code></tref> is set to <code>unordered</code></li>
     </ul>
     <p>For background on the trade-offs between these options, see 
@@ -307,7 +307,7 @@
      by the consuming application. In RDF, values can be tagged with a
      datatype or a language. According to the microdata specification, the
      HTML context of microdata markup should not change how microdata is
-     interpreted, so although element names and HTML lang attributes could
+     interpreted, so although element names and HTML <code>@lang</code> attributes could
      be used to provide datatype and language information for RDF data, this
      would be contrary to the microdata specification.</li>
   </ul>
@@ -438,7 +438,7 @@
     </dd>
     <dt><adef>itemtype</adef></dt><dd>
       An additional attribute on an element used to specify one or more types of an <tref>item</tref>.
-      The <tdef>item type</tdef> of an item, is the first value returned from
+      The <tdef>item type</tdef> of an <tref>item</tref> is the first value returned from
       <code><cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-itemtype">element.itemType</a></cite></code>
       on the element.
       The <tref>item type</tref> is also used to resolve non-URL <tref>name</tref>s to <tref>absolute URL</tref>s.
@@ -781,7 +781,7 @@
         </dl>
       </dd>
       <dt><tdef>item</tdef></dt><dd>
-         An <tref>item</tref> is defined as an element containing an <aref>itemscope</aref> attribute. The list
+         An <tref>item</tref> is described by an element containing an <aref>itemscope</aref> attribute. The list
          of top-level microdata items may be retrieved using the
          <a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#microdata-dom-api">Microdata DOM API</a></cite>
          <code><cite><a href="http://www.w3.org/TR/2011/WD-microdata-20110525/#dom-getitems">document.getItems</a></cite></code>
@@ -819,7 +819,7 @@
         [[!MICRODATA]]).
       </dd>
       <dt><tdef>literal</tdef></dt><dd>
-        Literals a values such as strings and dates, including <tdef>typed literal</tdef>s and
+        Literals are values such as strings and dates, including <tdef>typed literal</tdef>s and
         <tdef>plain literal</tdef>s.
         (See [[RDF-CONCEPTS]]).
       </dd>
@@ -1208,7 +1208,7 @@
         Create a new array <em>array</em> containing a <tref>blank node</tref> for every value in <em>list</em>.
       </li>
       <li>
-        For each pair of <em>bnode</em> from <em>array</em> and <em>value</em> and <em>list</em> the following
+        For each pair of <em>bnode</em> from <em>array</em> and <em>value</em> from <em>list</em> the following
         triple is generated:
         <dl class="triple">
           <dt>subject</dt>
@@ -1299,7 +1299,9 @@
 -->
 </pre>
 
-<p>The following snippet of HTML has microdata for two people with the same address:</p>
+<p>The following snippet of HTML has microdata for two people with the same address. This illustrates two
+  <tref>item</tref>s referencing a third item, and how only a single RDF resource definition is created
+  for that third item.</p>
 <pre class="example" data-transform="updateExample">
 <!--
 <p>