From fea8c63e09e0467619f24cc899fe25e8de35d9cf Mon Sep 17 00:00:00 2001
From: Drew Rygh <drew.rygh@gmail.com>
Date: Thu, 12 Nov 2015 16:07:49 -0600
Subject: [PATCH] docs(item): add use cases of ion-item

Closes #294
---
 ionic/components/item/item.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/ionic/components/item/item.ts b/ionic/components/item/item.ts
index 5b2aa45f2c..19fde8f2c0 100644
--- a/ionic/components/item/item.ts
+++ b/ionic/components/item/item.ts
@@ -5,6 +5,11 @@ import {Component} from 'angular2/angular2';
  * Creates a list-item that can easily be swiped,
  * deleted, reordered, edited, and more.
  *
+ * There are three common ways to use an item: 
+ * - Use `<ion-item>` for something that is only non-clickable text.
+ * - Use `<button ion-item>` for something that can be clicked/tapped. Typically this element will also have a `(click)` handler.
+ * - Use `<a ion-item>` for when the item needs to contain a `href`.
+ *
  * @usage
  * ```html
  * <ion-list>
@@ -16,6 +21,7 @@ import {Component} from 'angular2/angular2';
  *   </ion-item>
  * </ion-list>
  *  ```
+ * 
  */
 @Component({
   selector: 'ion-item,[ion-item]',