--- a/html-data-guide/index.html	Mon Dec 12 17:05:42 2011 +0000
+++ b/html-data-guide/index.html	Sat Dec 17 20:16:32 2011 +0000
@@ -114,8 +114,13 @@
         <dd>Microdata adds attributes to HTML to provide machine-readable descriptions of items within the page in terms of <a title="property">properties</a> and <a title="value">values</a> for those properties. It is designed to be used alongside detailed specifications of how these descriptions should be processed by consumers.</dd>
       </dl>
       <p>
-        The three <a title="syntax">syntaxes</a> are similar in goals but differ in approach. This document provides guidance about how to choose between them and use them together.
+        The three <a title="syntax">syntaxes</a> are similar in goals but differ in approach. This document provides guidance about how to choose between them and use them together as well as some good practices for publishing, consuming and designing vocabularies for HTML data. However, it is not intended to be a general-purpose introduction to any of these syntaxes. As well as the specifications themselves, examples and explanations can be found within:
       </p>
+      <ul>
+        <li><a href="http://microformats.org/wiki">the microformats wiki</a></li>
+        <li><a href="http://www.w3.org/TR/rdfa-primer/">the RDFa primer</a></li>
+        <li><a href="http://schema.org">the schema.org website</a></li>
+      </ul>
       
       <section>
         <h3>Scope</h3>
@@ -359,10 +364,7 @@
 &lt;a href=&quot;wells-fargo-center.html&quot;&gt;
 Wells Fargo Center
 &lt;/a&gt;
-Philadelphia, PA
-
-Priced from: $35
-1938 tickets left</pre>
+Philadelphia, PA</pre>
             <p>
               In this case there are three options available to you. The first, if consumers support it, is to use a different <a>syntax</a> for one of the <a title="vocabulary">vocabularies</a>. For example, the vEvent vocabulary is only supported in microdata but schema.org can be consumed from either microdata or RDFa, so it would be possible to mark up the data using the vEvent vocabulary in microdata and the schema.org vocabulary in RDFa. This approach is described in more detail in <a href="#mixing-syntaxes" class="sectionRef"></a>. Mixing syntaxes within a single page is rarely a good option but in some circumstances it may be preferable to the other workarounds described here.
             </p>
@@ -405,11 +407,6 @@
       &lt;/div&gt;
     &lt;/div&gt;</strong>
   &lt;/div&gt;
-
-  <strong>&lt;div itemprop=&quot;http://schema.org/offers&quot; itemscope itemtype=&quot;http://schema.org/AggregateOffer&quot;&gt;
-    Priced from: &lt;span itemprop=&quot;lowPrice&quot;&gt;$35&lt;/span&gt;
-    &lt;span itemprop=&quot;offerCount&quot;&gt;1938&lt;/span&gt; tickets left
-  &lt;/div&gt;</strong>
 &lt;/div&gt;</pre>
               <p class="note">
                 The vEvent <code>location</code> <a>property</a> takes text while the schema.org <code>location</code> property takes structured information about the location. These are combined by having an element for the property which requires structured information nested within the property that requires text.
@@ -440,13 +437,6 @@
           }
         }]
       }
-    }],
-    "http://schema.org/offers": [{
-      "type": [ "http://schema.org/AggregateOffer" ],
-      "properties": {
-        "lowPrice": [ "$35" ],
-        "offerCount": [ "1938" ]
-      }
     }]
   }
 }</pre>
@@ -471,13 +461,6 @@
           }
         }]
       }
-    }],
-    "offers": [{
-      "type": [ "http://schema.org/AggregateOffer" ],
-      "properties": {
-        "lowPrice": [ "$35" ],
-        "offerCount": [ "1938" ]
-      }
     }]
   }
 }</pre>
@@ -528,11 +511,6 @@
         &lt;span itemprop=&quot;addressRegion&quot;&gt;PA&lt;/span&gt;
       &lt;/div&gt;
     &lt;/div&gt;
-
-    &lt;div itemprop=&quot;offers&quot; itemscope itemtype=&quot;http://schema.org/AggregateOffer&quot;&gt;
-      Priced from: &lt;span itemprop=&quot;lowPrice&quot;&gt;$35&lt;/span&gt;
-      &lt;span itemprop=&quot;offerCount&quot;&gt;1938&lt;/span&gt; tickets left
-    &lt;/div&gt;
   &lt;/div&gt;
 &lt;/div&gt;</pre>
               <p>
@@ -565,13 +543,6 @@
             }
           }]
         }
-      }],
-      "offers": [{
-        "type": [ "http://schema.org/AggregateOffer" ],
-        "properties": {
-          "lowPrice": [ "$35" ],
-          "offerCount": [ "1938" ]
-        }
       }]
     }
   }]
@@ -623,11 +594,6 @@
       &lt;span <strong>property=&quot;addressRegion&quot;</strong>&gt;PA&lt;/span&gt;
     &lt;/div&gt;
   &lt;/div&gt;
-
-  &lt;div <strong>vocab=&quot;http://schema.org/&quot; property=&quot;offers&quot; typeof=&quot;AggregateOffer&quot;</strong>&gt;
-    Priced from: &lt;span <strong>property=&quot;lowPrice&quot;</strong>&gt;$35&lt;/span&gt;
-    &lt;span <strong>property=&quot;offerCount&quot;</strong>&gt;1938&lt;/span&gt; tickets left
-  &lt;/div&gt;
 &lt;/div&gt;</pre>
           <p>
             A microformats processor will extract the data:
@@ -667,11 +633,6 @@
     schema:url &lt;http://example.com/wells-fargo-center.html&gt; ;
   ] ;
   schema:name " Miami Heat at Philadelphia 76ers - Game 3 (Home Game 1) " ;
-  schema:offers [ 
-    a schema:AggregateOffer ;
-    schema:lowPrice "$35" ;
-    schema:offerCount "1938" ;
-  ] ;
   schema:startDate "2016-04-21T20:00:00"^^xsd:dateTime ;
   schema:url &lt;http://example.com/nba-miami-philadelphia-game3.html&gt; ;
   .</pre>