diff --git a/ionic/components/item/item.ts b/ionic/components/item/item.ts
index 48e521a0ef..786f1ecf9e 100644
--- a/ionic/components/item/item.ts
+++ b/ionic/components/item/item.ts
@@ -24,7 +24,22 @@ import {dom} from 'ionic/util';
 })
 export class Item {
   /**
-   * TODO
+   * @name ionItem
+   * @classdesc
+   * Creates a list-item that can easily be swiped,
+   * deleted, reordered, edited, and more.
+   *
+   * @example
+   * ```html
+   *  <ion-list>
+   *    <ion-item *ng-for="#item of items" (^click)="itemTapped($event, item)">
+   *      {{item.title}}
+   *      <div class="item-note" item-right>
+   *        {{item.note}}
+   *      </div>
+   *    </ion-item>
+   *  </ion-list>
+   * ```
    * @param {ElementRef} elementRef  TODO
    */
   constructor(elementRef: ElementRef) {
diff --git a/ionic/components/list/list.ts b/ionic/components/list/list.ts
index 0dcad7a945..2fa20834fa 100644
--- a/ionic/components/list/list.ts
+++ b/ionic/components/list/list.ts
@@ -19,7 +19,17 @@ import * as util from 'ionic/util';
 })
 export class List extends Ion {
   /**
-   * TODO
+   * @name ionList
+   * @classdesc
+   * The List is a widely used interface element in almost any mobile app, and can include
+   * content ranging from basic text all the way to buttons, toggles, icons, and thumbnails.
+   *
+   * Both the list, which contains items, and the list items themselves can be any HTML
+   * element.
+   *
+   * Using the ionList and ionItem components make it easy to support various
+   * interaction modes such as swipe to edit, drag to reorder, and removing items.
+   *
    * @param {ElementRef} elementRef  TODO
    * @param {IonicConfig} config  TODO
    */