From 58a0bfae4d9f93b6d4d49773b6e51e704b734036 Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Mon, 12 Jun 2017 19:32:26 -0700
Subject: [PATCH 1/9] Forward base-href property to iron-doc-viewer.

---
 iron-component-page.html | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/iron-component-page.html b/iron-component-page.html
index bd1c5ff..a86f014 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -97,6 +97,7 @@
 
         <iron-doc-viewer
             descriptor="[[_descriptor]]"
+            base-href="[[baseHref]]"
             title="{{_title}}"
             path="{{_path}}">
         </iron-doc-viewer>
@@ -116,6 +117,15 @@
             observer: '_descriptorUrlChanged'
           },
 
+          /**
+           * By default all routing is performed using the URL fragment
+           * (e.g. `docs.html#/elements/my-element`). If your server supports
+           * it and you would like to use the real URL path instead (e.g.
+           * `/docs/elements/my-element`), set this to the base path where the
+           * page is mounted (e.g. `/` or `/docs/`).
+           */
+          baseHref: String,
+
           _loading: Boolean,
 
           _error: Object,

From a7c67b4a794ebb81417f36fe5d3e6fe828740bff Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Mon, 12 Jun 2017 21:46:24 -0700
Subject: [PATCH 2/9] Default to analysis.json URL.

---
 iron-component-page.html | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/iron-component-page.html b/iron-component-page.html
index a86f014..fda5c42 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -112,8 +112,12 @@
         is: 'iron-component-page',
 
         properties: {
+          /**
+           * URL of the Polymer Analyzer descriptor to fetch and display.
+           */
           descriptorUrl: {
             type: String,
+            value: 'analysis.json',
             observer: '_descriptorUrlChanged'
           },
 

From c58af7221741b8c75f80c8fb6fb744d99f88fb34 Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Mon, 12 Jun 2017 22:09:10 -0700
Subject: [PATCH 3/9] Remove inert default view code.

---
 iron-component-page.html | 19 -------------------
 1 file changed, 19 deletions(-)

diff --git a/iron-component-page.html b/iron-component-page.html
index fda5c42..a740e4c 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -166,25 +166,6 @@
           this._changing = true;
           this._descriptor = _flatten(descriptor);
           this._changing = false;
-
-          return;
-
-          var behaviors = descriptor.metadata
-              && descriptor.metadata.polymer
-              && descriptor.metadata.polymer.behaviors;
-
-          if ((descriptor.namespaces || []).length) {
-            this._path = '/namespaces/' + descriptor.namespaces[0].name;
-          } else if ((descriptor.elements || []).length) {
-            var element = descriptor.elements;
-            this._path = '/elements/' + (element.tagname || element.name);
-          } else if ((behaviors || []).length) {
-            this._path = '/behaviors/' + behaviors[0].name;
-          } else if ((descriptor.mixins || []).length) {
-            this._path = '/mixins/' + descriptor.mixins[0].name;
-          } else if ((descriptor.classes || []).length) {
-            this._path = '/classes/' + descriptor.classes[0].name;
-          }
         },
 
         _titleChanged(title) {

From fe0eab9c8fdadbaded8e9a1a41628914a5d24e5b Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Mon, 12 Jun 2017 22:15:34 -0700
Subject: [PATCH 4/9] Don't show hamburger unless in narrow layout.

---
 iron-component-page.html | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/iron-component-page.html b/iron-component-page.html
index a740e4c..5744e03 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -26,8 +26,12 @@
 <dom-module id="iron-component-page">
   <template>
     <style include="iron-doc-viewer-default-theme">
+      [hidden] {
+        display: none;
+      }
+
       iron-doc-viewer {
-        margin: 16px 0 0 24px;
+        margin: 20px 0 0 20px;
         max-width: 56em;
       }
 
@@ -77,7 +81,7 @@
       Could not load descriptor "[[descriptorUrl]]". <br> [[_error.error]]
     </paper-toast>
 
-    <app-drawer-layout id="layout" fullbleed>
+    <app-drawer-layout fullbleed narrow="{{_narrow}}">
 
       <app-drawer id="drawer" slot="drawer" swipe-open>
         <iron-doc-nav
@@ -90,7 +94,12 @@
       <app-header-layout>
         <app-header slot="header" fixed>
           <app-toolbar>
-            <paper-icon-button icon="menu" drawer-toggle></paper-icon-button>
+            <paper-icon-button
+                icon="menu"
+                drawer-toggle
+                hidden$="[[!_narrow]]">
+            </paper-icon-button>
+
             <div condensed-title>[[_title]]</div>
           </app-toolbar>
         </app-header>
@@ -141,6 +150,8 @@
 
           _path: String,
 
+          _narrow: Boolean,
+
           _title: {
             type: String,
             observer: '_titleChanged'
@@ -149,7 +160,7 @@
 
         _onNavSelect() {
           document.body.scrollTop = 0;
-          if (this.$.layout.narrow) {
+          if (this._narrow) {
             this.$.drawer.close();
           }
         },

From 59b24d5f876dedcd08c38a08f2c8a50b5b56e086 Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Mon, 12 Jun 2017 22:33:22 -0700
Subject: [PATCH 5/9] Add comment about why we listen for nav select event.

---
 iron-component-page.html | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/iron-component-page.html b/iron-component-page.html
index 5744e03..6b687a1 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -159,7 +159,10 @@
         },
 
         _onNavSelect() {
-          document.body.scrollTop = 0;
+          // Note we need to listen for this event, and can't rely just on the
+          // path changing, because the user might click on the nav item they
+          // are already viewing.
+          window.document.body.scrollTop = 0;
           if (this._narrow) {
             this.$.drawer.close();
           }

From e8f7573f56224f4871f4bcdf1d7266b6e03c4256 Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Tue, 13 Jun 2017 12:17:33 -0700
Subject: [PATCH 6/9] New default-theme name.

---
 iron-component-page.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/iron-component-page.html b/iron-component-page.html
index 6b687a1..0110fe3 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -14,8 +14,8 @@
 <link rel="import" href="../app-layout/app-header-layout/app-header-layout.html">
 <link rel="import" href="../app-layout/app-toolbar/app-toolbar.html">
 <link rel="import" href="../iron-ajax/iron-ajax.html">
+<link rel="import" href="../iron-doc-viewer/default-theme.html">
 <link rel="import" href="../iron-doc-viewer/iron-doc-nav.html">
-<link rel="import" href="../iron-doc-viewer/iron-doc-viewer-default-theme.html">
 <link rel="import" href="../iron-doc-viewer/iron-doc-viewer.html">
 <link rel="import" href="../iron-icons/iron-icons.html">
 <link rel="import" href="../paper-icon-button/paper-icon-button.html">
@@ -25,7 +25,7 @@
 
 <dom-module id="iron-component-page">
   <template>
-    <style include="iron-doc-viewer-default-theme">
+    <style include="iron-doc-default-theme">
       [hidden] {
         display: none;
       }

From 6b2dc0d37717979b952a42ba7421460dc0ee1a70 Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Tue, 13 Jun 2017 12:30:44 -0700
Subject: [PATCH 7/9] Fix app-header masking items scrolled into view.

---
 iron-component-page.html | 25 +++++++++++++++++++------
 1 file changed, 19 insertions(+), 6 deletions(-)

diff --git a/iron-component-page.html b/iron-component-page.html
index 0110fe3..8372a46 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -53,6 +53,17 @@
         overflow-x: hidden;
       }
 
+      /**
+       * iron-doc-viewer uses scrollIntoView for fragment links, but this
+       * doesn't take into account our app-header, so by default when our
+       * scroll block is the document, we'll scroll things hidden underneath
+       * the app-header.
+       */
+      #scroller {
+        overflow-y: auto;
+        height: calc(100vh - 64px);
+      }
+
       iron-doc-viewer {
         --iron-doc-title: {
           display: none;
@@ -104,12 +115,14 @@
           </app-toolbar>
         </app-header>
 
-        <iron-doc-viewer
-            descriptor="[[_descriptor]]"
-            base-href="[[baseHref]]"
-            title="{{_title}}"
-            path="{{_path}}">
-        </iron-doc-viewer>
+        <div id="scroller">
+          <iron-doc-viewer
+              descriptor="[[_descriptor]]"
+              base-href="[[baseHref]]"
+              title="{{_title}}"
+              path="{{_path}}">
+          </iron-doc-viewer>
+        </div>
 
       </app-header-layout>
     </app-drawer-layout>

From 94667bcb4b68ba6eb538616774e59053329e766c Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Tue, 13 Jun 2017 12:36:53 -0700
Subject: [PATCH 8/9] Don't wrap title bar.

---
 iron-component-page.html | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/iron-component-page.html b/iron-component-page.html
index 8372a46..0a0a677 100644
--- a/iron-component-page.html
+++ b/iron-component-page.html
@@ -41,6 +41,10 @@
         background-color: #5a5a5a;
       }
 
+      [condensed-title] {
+        white-space: nowrap;
+      }
+
       app-drawer {
         --app-drawer-content-container: {
           background-color: #f9f9f9;

From 27ec3c4c183afa0edcdf9fa1c73a3ceaad39d5de Mon Sep 17 00:00:00 2001
From: Alexander Marks <aomarks@google.com>
Date: Tue, 13 Jun 2017 13:53:55 -0700
Subject: [PATCH 9/9] Pin to iron-doc-viewer 3 release candidate.

---
 bower.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/bower.json b/bower.json
index 5cb8c07..f98858d 100644
--- a/bower.json
+++ b/bower.json
@@ -19,7 +19,7 @@
   "dependencies": {
     "app-layout": "PolymerElements/app-layout#1 - 2",
     "iron-ajax": "PolymerElements/iron-ajax#1 - 2",
-    "iron-doc-viewer": "PolymerElements/iron-doc-viewer#master",
+    "iron-doc-viewer": "PolymerElements/iron-doc-viewer#>=3.0.0-rc.1",
     "iron-icons": "PolymerElements/iron-icons#1 - 2",
     "paper-icon-button": "PolymerElements/paper-icon-button#1 - 2",
     "paper-styles": "PolymerElements/paper-styles#1 - 2",
@@ -35,7 +35,7 @@
       "dependencies": {
         "app-layout": "PolymerElements/app-layout#^1.0.0",
         "iron-ajax": "PolymerElements/iron-ajax#^1.0.0",
-        "iron-doc-viewer": "PolymerElements/iron-doc-viewer#master",
+        "iron-doc-viewer": "PolymerElements/iron-doc-viewer#>=3.0.0-rc.1",
         "iron-icons": "PolymerElements/iron-icons#^1.0.0",
         "paper-icon-button": "PolymerElements/paper-icon-button#^1.0.0",
         "paper-styles": "PolymerElements/paper-styles#^1.0.0",