More feedback from Jeni.
--- 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>