Copyedits

polymer-ajax.html

@@ -9,17 +9,24 @@
  */
  
 /**
- * polymer-ajax can be used to perform XMLHttpRequests.
- *
- * Note: The params attribute must be double quoted JSON
+ * The `polymer-ajax` element performs `XMLHttpRequest`s.
+ * 
+ * You can trigger a request explicitly by calling `go` on the
+ * element. 
+ * 
+ * With `auto` set to `true`, the element performs a request whenever
+ * its `url` or `params` properties are changed.
  * 
+ *
  * Example:
  *
  *     <polymer-ajax auto url="http://gdata.youtube.com/feeds/api/videos/" 
  *         params='{"alt":"json", "q":"chrome"}'
  *         handleAs="json"
  *         on-polymer-response="{{handleResponse}}">
  *     </polymer-ajax>
+ * 
+ * Note: The `params` attribute must be double quoted JSON.
  *
  * @class polymer-ajax
  * @status beta
@@ -61,24 +68,24 @@
        */
       url: '',
       /**
-       * Specifies what data to store in the 'response' property, and
-       * to deliver as 'event.response' in 'response' events.
+       * Specifies what data to store in the `response` property, and
+       * to deliver as `event.response` in `response` events.
        * 
        * One of:
        * 
-       *    `text`: uses XHR.responseText
+       *    `text`: uses `XHR.responseText`.
        *    
-       *    `xml`: uses XHR.responseXML
+       *    `xml`: uses `XHR.responseXML`.
        *    
-       *    `json`: uses XHR.responseText parsed as JSON
+       *    `json`: uses `XHR.responseText` parsed as JSON.
        *  
        * @attribute handleAs
        * @type string
        * @default 'text'
        */
       handleAs: '',
       /**
-       * If true, automatically performs an Ajax request when either url or params has changed.
+       * If true, automatically performs an Ajax request when either `url` or `params` changes.
        *
        * @attribute auto
        * @type boolean
@@ -102,7 +109,7 @@
        */
       response: null,
       /**
-       * The HTTP method to use such as 'GET', 'POST', 'PUT', 'DELETE'.
+       * The HTTP method to use such as 'GET', 'POST', 'PUT', or 'DELETE'.
        * Default is 'GET'.
        *
        * @attribute method
@@ -127,7 +134,7 @@
        */
       headers: null,
       /**
-       * Optional raw body content to send when method === "POST"
+       * Optional raw body content to send when method === "POST".
        *
        * Example:
        *
@@ -218,7 +225,7 @@
         }
       },
       /**
-       * Performs an Ajax request to the url specified.
+       * Performs an Ajax request to the specified URL.
        *
        * @method go
        */