+
+ (show-when="ios") This text is shown on iOS only. Click the Android tab to hide this text.
+
+
diff --git a/ionic/components/action-sheet/action-sheet.ts b/ionic/components/action-sheet/action-sheet.ts
index 88b4516b02..a59d9280d8 100644
--- a/ionic/components/action-sheet/action-sheet.ts
+++ b/ionic/components/action-sheet/action-sheet.ts
@@ -109,6 +109,7 @@ class ActionSheetCmp {
* }
* ```
*
+ * @demo /docs/v2/demos/action-sheet/
* @see {@link /docs/v2/components#action-sheets ActionSheet Component Docs}
*/
@Injectable()
diff --git a/ionic/components/show-hide-when/show-hide-when.ts b/ionic/components/show-hide-when/show-hide-when.ts
index 22827aa989..3c150bdf25 100644
--- a/ionic/components/show-hide-when/show-hide-when.ts
+++ b/ionic/components/show-hide-when/show-hide-when.ts
@@ -53,12 +53,15 @@ class DisplayWhen {
/**
*
- * The `show-when` attribute takes a value or expression, and only shows the element it has been added to when
- * the value or expression is true. Complements the [hide-when attribute](../HideWhen).
+ * The `show-when` attribute takes a string that represents a plaform or screen orientation.
+ * The element the attribute is added to will only be shown when that platform or screen orientation is active.
+ * Complements the [hide-when attribute](../HideWhen).
* @usage
* ```html
- * I am hidden!
+ * I am only visible on iOS!
* ```
+ * @demo /docs/v2/demos/show-when/
+ * @see {@link ../HideWhen HideWhen API Docs}
*/
@Directive({
selector: '[show-when]',
@@ -87,12 +90,15 @@ export class ShowWhen extends DisplayWhen {
/**
*
- * The `hide-when` attribute takes a value or expression, and hides the element it has been added to when
- * the value or expression is true. Complements the [show-when attribute](../ShowWhen).
+ * The `hide-when` attribute takes a string that represents a plaform or screen orientation.
+ * The element the attribute is added to will only be hidden when that platform or screen orientation is active.
+ * Complements the [show-when attribute](../ShowWhen).
* @usage
* ```html
- * I am hidden!
+ * I am hidden on Android!
* ```
+ * @demo /docs/v2/demos/hide-when/
+ * @see {@link ../ShowWhen ShowWhen API Docs}
*/
@Directive({
selector: '[hide-when]',