diff --git a/ionic/components/action-sheet/action-sheet.ts b/ionic/components/action-sheet/action-sheet.ts
index 8c55137457..06f2152dc9 100644
--- a/ionic/components/action-sheet/action-sheet.ts
+++ b/ionic/components/action-sheet/action-sheet.ts
@@ -120,8 +120,18 @@ export class ActionSheet {
    * public API, and most often you will only use ActionSheet.open()
    *
    * @param {Object} [opts={}]  An object containing optional settings.
-   * @param {String} [opts.pageType='action-sheet'] The page type that determines how the page renders and animates.
-   * @param {String} [opts.enterAnimation='action-sheet-slide-in'] The class used to animate an actionSheet that is entering. 
+   *  - `[Object]` `buttons` Which buttons to show.  Each button is an object with a `text` field.
+   *  - `{string}` `titleText` The title to show on the action sheet.
+   *  - `{string=}` `cancelText` the text for a 'cancel' button on the action sheet.
+   *  - `{string=}` `destructiveText` The text for a 'danger' on the action sheet.
+   *  - `{function=}` `cancel` Called if the cancel button is pressed, the backdrop is tapped or
+   *     the hardware back button is pressed.
+   *  - `{function=}` `buttonClicked` Called when one of the non-destructive buttons is clicked,
+   *     with the index of the button that was clicked and the button object. Return true to close
+   *     the action sheet, or false to keep it opened.
+   *  - `{function=}` `destructiveButtonClicked` Called when the destructive button is clicked.
+   *     Return true to close the action sheet, or false to keep it opened.
+   * @param {String} [opts.enterAnimation='action-sheet-slide-in'] The class used to animate an actionSheet that is entering.
    * @param {String} [opts.leaveAnimation='action-sheet-slide-out'] The class used to animate an actionSheet that is leaving.
    * @return {Promise} Promise that resolves when the action sheet is open.
    */
diff --git a/scripts/docs/templates/common.template.html b/scripts/docs/templates/common.template.html
index 6948c341ea..ed4cf04820 100644
--- a/scripts/docs/templates/common.template.html
+++ b/scripts/docs/templates/common.template.html
@@ -151,8 +151,8 @@ Delegate: <$ doc.delegate $>
 <@ endif -@>
 
 
-<h2>Usage</h2>
 <@ if doc.usage @>
+<h2>Usage</h2>
 <@ block usage @>
 <$ doc.usage | marked $>
 <@ endblock @>