Rework API reference pages

chrome/common/extensions/docs/templates/private/api.html

Index: chrome/common/extensions/docs/templates/private/api.html
diff --git a/chrome/common/extensions/docs/templates/private/api.html b/chrome/common/extensions/docs/templates/private/api.html
index 6052a6d112ae3752916c4c11ae6d3ab6beb989e3..5ea5e6a488c3eab9d16c59c01051780ef09a0954 100644
--- a/chrome/common/extensions/docs/templates/private/api.html
+++ b/chrome/common/extensions/docs/templates/private/api.html
@@ -13,20 +13,22 @@
 {{?api.channelWarning.trunk +partials.warning_trunk/}}
 {{?api.channelWarning.dev   +partials.warning_dev/}}
 {{?api.channelWarning.beta  +partials.warning_beta/}}
-<h1>{{api.title}}</h1>
-{{?api.deprecated +partials.warning_deprecated item:api/}}

[Jeffrey Yasskin, 2014/02/07 02:40:03]

Does this need to exist somewhere else?

-$(table_of_contents)
-{{+partials.intro_table api:api /}}
-{{?intro}}
-<section>
-{{+intro platform:platform platformTitle:platformTitle /}}
-</section>
-{{/intro}}
-<section>
-<h2 id="api-reference-header" title="">{{api.namespace}} reference</h2>
-{{+partials.api_reference api:api
-                          platform:platform
-                          platformTitle:platformTitle
-                          samplesForApi:samplesForApi /}}
-</section>
+<article>
+  <div itemprop="articleBody" class="api">

[Jeffrey Yasskin, 2014/02/07 02:40:03]

This is an odd use of itemprop:
http://developers.whatwg.org/microdata.html#names:-the-itemprop-attribute.
There's no itemscope to create the item it's a property on. What's it for? 

Do you need the separate <article> and <div> layers at all? Can they just be a
single element?

+    <h1>{{api.title}}</h1>
+    {{+partials.intro_table api:api /}}
+    {{?intro}}
+    <section>
+      {{+intro platform:platform platformTitle:platformTitle /}}
+    </section>
+    {{/intro}}
+    {{+partials.api_summary api:api/}}
+    <section>
+      {{+partials.api_reference api:api
+                                platform:platform
+                                platformTitle:platformTitle
+                                samplesForApi:samplesForApi /}}
+    </section>
+  </div>
+</article>
 {{/partials.site}}