docs(actionSheet): improve docs

scripts/docs/tag-defs/tag-defs.js

@@ -1,4 +1,5 @@
 module.exports = [
+  {'name': 'advanced'},
   {'name': 'demo'},
   {'name': 'usage'}
 ];

scripts/docs/templates/common.template.html

@@ -276,6 +276,13 @@ docType: "<$ doc.docType $>"
 
 <@- endif -@>
 
+<@ block advanced @>
+<@- if doc.advanced -@>
+<h2><a class="anchor" name="advanced" href="#advanced"></a>Advanced</h2>
+<$ doc.advanced | marked $>
+<@- endif -@>
+<@ endblock @>
+
 <!-- related link -->
 <@- if doc.see @>
 

src/plugins/actionsheet.ts

@@ -22,17 +22,8 @@ import {Plugin, Cordova} from './plugin';
  * });
  * ```
  *
- */
+ * @advanced
-@Plugin({
+ * ActionSheet options
-  plugin: 'cordova-plugin-actionsheet',
-  pluginRef: 'plugins.actionsheet',
-  repo: 'https://github.com/EddyVerbruggen/cordova-plugin-actionsheet',
-  platforms: ['Android', 'iOS', 'Windows Phone 8']
-})
-export class ActionSheet {
-
-  /**
-   * Show the ActionSheet. The ActionSheet's options is an object with the following propterties.
  *
  * | Option                        | Type      | Description                                  |
  * |-------------------------------|-----------|----------------------------------------------|
@@ -45,7 +36,19 @@ export class ActionSheet {
  * | addDestructiveButtonWithLabel |`string`   | Add a destructive button with text           |
  * | position                      |`number[]` | On an iPad, set the X,Y position             |
  *
-   * @param {options} Options See table above
+ *
+ */
+@Plugin({
+  plugin: 'cordova-plugin-actionsheet',
+  pluginRef: 'plugins.actionsheet',
+  repo: 'https://github.com/EddyVerbruggen/cordova-plugin-actionsheet',
+  platforms: ['Android', 'iOS', 'Windows Phone 8']
+})
+export class ActionSheet {
+
+  /**
+   * Show a native ActionSheet component. See below for options.
+   * @param {options} Options See table below
    * @returns {Promise} Returns a Promise that resolves with the index of the
    *   button pressed (1 based, so 1, 2, 3, etc.)
    */
@@ -63,7 +66,8 @@ export class ActionSheet {
 
 
   /**
-   * Hide the ActionSheet.
+   * Progamtically hide the native ActionSheet
+   * @returns {Promise} Returns a Promise that resolves when the actionsheet is closed
    */
   @Cordova()
   static hide(): Promise<any> { return; }