Upgrade to 1.0 and switch clients to dom-repeat where needed.

third_party/polymer/v0_8/components-chromium/iron-selector/README.md

Index: third_party/polymer/v0_8/components-chromium/iron-selector/README.md
diff --git a/third_party/polymer/v0_8/components-chromium/iron-selector/README.md b/third_party/polymer/v0_8/components-chromium/iron-selector/README.md
index 31667a3dac3f1dda4db142f977b5ea3962de3ecb..8bb3d64bad06ba7ebc9a3ef950fc08f90f668161 100644
--- a/third_party/polymer/v0_8/components-chromium/iron-selector/README.md
+++ b/third_party/polymer/v0_8/components-chromium/iron-selector/README.md
@@ -1,2 +1,50 @@
 iron-selector
 =============
+
+`iron-selector` is an element which can be used to manage a list of elements
+that can be selected.  Tapping on the item will make the item selected.  The `selected` indicates
+which item is being selected.  The default is to use the index of the item.
+
+Example:
+
+```html
+<iron-selector selected="0">
+  <div>Item 1</div>
+  <div>Item 2</div>
+  <div>Item 3</div>
+</iron-selector>
+```
+
+If you want to use the attribute value of an element for `selected` instead of the index,
+set `attrForSelected` to the name of the attribute.  For example, if you want to select item by
+`name`, set `attrForSelected` to `name`.
+
+Example:
+
+```html
+<iron-selector attr-for-selected="name" selected="foo">
+  <div name="foo">Foo</div>
+  <div name="bar">Bar</div>
+  <div name="zot">Zot</div>
+</iron-selector>
+```
+
+`iron-selector` is not styled. Use the `iron-selected` CSS class to style the selected element.
+
+Example:
+
+```html
+<style>
+  .iron-selected {
+    background: #eee;
+  }
+</style>
+
+...
+
+<iron-selector selected="0">
+  <div>Item 1</div>
+  <div>Item 2</div>
+  <div>Item 3</div>
+</iron-selector>
+```