From adefa0578917f031c071172bde3051c0b64c2752 Mon Sep 17 00:00:00 2001
From: Ole Ersoy <ole.mk10@gmail.com>
Date: Fri, 19 Aug 2016 18:03:45 -0500
Subject: [PATCH 1/2] Update iron-location.html

---
 iron-location.html | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/iron-location.html b/iron-location.html
index a13b070..8a1cd2b 100644
--- a/iron-location.html
+++ b/iron-location.html
@@ -12,12 +12,14 @@
 
 <!--
 
-The `iron-location` element manages binding to and from the current URL.
+The `iron-location` element manages binding to and from the current URL and 
+thus fits well as a base building block for routing systems.  
 
-iron-location is the first, and lowest level element in the Polymer team's
-routing system. This is a beta release of iron-location as we continue work
-on higher level elements, and as such iron-location may undergo breaking
-changes.
+For an example of such a use case see the 
+[app-location](https://github.com/PolymerElements/app-route/blob/master/app-location.html) element.
+
+This is a beta release of `iron-location` and it may may undergo breaking
+changes as feedback is collected from the design of higher elements, such as `app-location`.
 
 #### Properties
 
@@ -29,20 +31,20 @@
 
 These bindings are bidirectional. Modifying them will in turn modify the URL.
 
-iron-location is only active while it is attached to the document.
+The `iron-location` element is only active while it is attached to the document.
 
 #### Links
 
 While iron-location is active in the document it will intercept clicks on links
-within your site, updating the URL pushing the updated URL out through the
-databinding system. iron-location only intercepts clicks with the intent to
-open in the same window, so middle mouse clicks and ctrl/cmd clicks work fine.
+within your site, publishing the updated URL via the the
+databinding system. Only clicks that perform navigation n the same window 
+are intercepted, so middle mouse clicks and ctrl/cmd clicks work fine.
 
-You can customize this behavior with the `urlSpaceRegex`.
+Customize this behavior with the `urlSpaceRegex` attribute.
 
 #### Dwell Time
 
-iron-location protects against accidental history spamming by only adding
+Accidental history spamming is avoided by only adding
 entries to the user's history if the URL stays unchanged for `dwellTime`
 milliseconds.
 

From 04b64129f48c4215009c68891545deab7ab128e0 Mon Sep 17 00:00:00 2001
From: Ole Ersoy <ole.mk10@gmail.com>
Date: Sun, 21 Aug 2016 18:06:13 -0500
Subject: [PATCH 2/2] Update iron-location.html

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

diff --git a/iron-location.html b/iron-location.html
index 8a1cd2b..0f81037 100644
--- a/iron-location.html
+++ b/iron-location.html
@@ -35,8 +35,8 @@
 
 #### Links
 
-While iron-location is active in the document it will intercept clicks on links
-within your site, publishing the updated URL via the the
+The `iron-location` element intercepts clicks on links
+and publishes them via the the
 databinding system. Only clicks that perform navigation n the same window 
 are intercepted, so middle mouse clicks and ctrl/cmd clicks work fine.