diff --git a/polymer-flex-layout/polymer-flex-layout.html b/polymer-flex-layout/polymer-flex-layout.html
index 6e5ae2c..72f9a17 100644
--- a/polymer-flex-layout/polymer-flex-layout.html
+++ b/polymer-flex-layout/polymer-flex-layout.html
@@ -3,6 +3,64 @@
 Use of this source code is governed by a BSD-style
 license that can be found in the LICENSE file.
 -->
+<!--
+/**
+ * @module Polymer Elements
+ */
+/**
+ * polymer-flex-layout provides a helper to use CSS3 Flexible Boxes.  By putting
+ * polymer-flex-layout inside an element it makes the element a flex
+ * container. Use 'flex' attribute to make the flex item flexible.
+ *
+ * Example:
+ *
+ *     <div>
+ *       <polymer-flex-layout></polymer-flex-layout>
+ *       <div>Left sidebar</div>
+ *       <div flex>Main content</div>
+ *       <div>Right sidebar</div>
+ *     </div>
+ *
+ *     <div>
+ *       <polymer-flex-layout></polymer-flex-layout vertical>
+ *       <div>Header</div>
+ *       <div flex>Body</div>
+ *       <div>Footer</div>
+ *     </div>
+ *
+ * @class polymer-flex-layout
+ */
+/**
+ * If true, flex items are aligned vertically.
+ *
+ * @attribute vertical
+ * @type boolean
+ * @default false
+ */
+/**
+ * Defines the default for how flex items are laid out along the cross axis on 
+ * the current line.  Possible values are 'start', 'center' and 'end'.
+ *
+ * @attribute align
+ * @type string
+ * @default ''
+ */
+/**
+ * Defines how flex items are laid out along the main axis on the current line.
+ * Possible values are 'start', 'center' and 'end'.
+ *
+ * @attribute justify
+ * @type string
+ * @default ''
+ */
+/**
+ * If true, polymer-flex-layout is the flex container.
+ *
+ * @attribute isContainer
+ * @type boolean
+ * @default false
+ */
+-->
 <polymer-element name="polymer-flex-layout" attributes="vertical align justify isContainer">
   <template>
     <link rel="stylesheet" polymer-scope="controller" href="polymer-flex-layout.css">