diff --git a/ionic/components/tabs/tabs.ts b/ionic/components/tabs/tabs.ts
index 5ea57da809..599f1e0c2d 100644
--- a/ionic/components/tabs/tabs.ts
+++ b/ionic/components/tabs/tabs.ts
@@ -59,8 +59,8 @@ import {isBlank, isTrueProperty} from '../../util/util';
  *
  * Since the index starts at `0`, this will select the 3rd tab which has
  * root set to `tab3Root`. You can also grab the `Tabs` instance and call
- * the `select()` method. This requires the `<ion-tab>` element to have an
- * `id`. For example, set the `id` to `myTabs`:
+ * the `select()` method. This requires the `<ion-tabs>` element to have
+ * an `id`. For example, set the `id` to `myTabs`:
  *
  * ```html
  * <ion-tabs id="myTabs">
@@ -71,9 +71,13 @@ import {isBlank, isTrueProperty} from '../../util/util';
  * ```
  *
  * Then in your JavaScript you can grab the `Tabs` instance and call `select()`.
- * In the following code `app` is of type `IonicApp`:
+ * In the following code `app` is of type [`IonicApp`](../../app/IonicApp/):
  *
  *```js
+ * constructor(app: IonicApp) {
+ *   this.app = app;
+ * }
+ *
  * onPageDidEnter() {
  *   let tabs = this.app.getComponent('myTabs');
  *   tabs.select(2);
@@ -83,8 +87,10 @@ import {isBlank, isTrueProperty} from '../../util/util';
  *
  * @usage
  * ```html
- * <ion-tabs>
- *   <ion-tab [root]="tabRoot"></ion-tab>
+ * <ion-tabs [selectedIndex]="mySelectedIndex" tabbarLayout="icon-bottom" secondary>
+ *   <ion-tab [root]="tab1Root"></ion-tab>
+ *   <ion-tab [root]="tab2Root"></ion-tab>
+ *   <ion-tab [root]="tab3Root"></ion-tab>
  * </ion-tabs>
  * ```
  *