Index: third_party/polymer/v0_8/components-chromium/iron-resizable-behavior/README.md |
diff --git a/third_party/polymer/v0_8/components-chromium/iron-resizable-behavior/README.md b/third_party/polymer/v0_8/components-chromium/iron-resizable-behavior/README.md |
index aef1969174bfbc6149091c13147528af0494f184..72be6def8c0dd0bb2e2835e34716e4a9c3c44639 100644 |
--- a/third_party/polymer/v0_8/components-chromium/iron-resizable-behavior/README.md |
+++ b/third_party/polymer/v0_8/components-chromium/iron-resizable-behavior/README.md |
@@ -1,4 +1,16 @@ |
iron-resizable-behavior |
======================= |
-See the [component page](http://polymer-project.org/docs/elements/iron-elements.html#iron-resizable-behavior) for more information. |
+`IronResizableBehavior` is a behavior that can be used in Polymer elements to |
+coordinate the flow of resize events between "resizers" (elements that control the |
+size or hidden state of their children) and "resizables" (elements that need to be |
+notified when they are resized or un-hidden by their parents in order to take |
+action on their new measurements). |
+ |
+Elements that perform measurement should add the `IronResizableBehavior` behavior to |
+their element definition and listen for the `iron-resize` event on themselves. |
+This event will be fired when they become showing after having been hidden, |
+when they are resized explicitly by another resizable, or when the window has been |
+resized. |
+ |
+Note, the `iron-resize` event is non-bubbling. |