diff --git a/ionic/components/nav/nav.ts b/ionic/components/nav/nav.ts
index 51a4996435..23322b7241 100644
--- a/ionic/components/nav/nav.ts
+++ b/ionic/components/nav/nav.ts
@@ -8,6 +8,8 @@ import {NavController} from './nav-controller';
 import {ViewController} from './view-controller';
 
 /**
+ * @name Nav
+ * @description
  * _For a quick walkthrough of navigation in Ionic, check out the
  * [Navigation section](../../../../components/#navigation) of the Component
  * docs._
diff --git a/ionic/components/navbar/navbar.ts b/ionic/components/navbar/navbar.ts
index 0566266e9f..99544590ea 100644
--- a/ionic/components/navbar/navbar.ts
+++ b/ionic/components/navbar/navbar.ts
@@ -62,6 +62,32 @@ class ToolbarBackground {
 
 /**
  * @name Navbar
+ * @description
+ * Navbar is a global level toolbar that gets updated every time a page gets
+ * loaded. You can pass the navbar a `ion-title` or any number of buttons.
+ *
+ * @usage
+ * ```html
+ * <ion-navbar *navbar>
+ *
+ *   <ion-buttons>
+ *     <button (click)="toggleItems()">
+ *       toggle
+ *     </button>
+ *   </ion-buttons>
+ *
+ *   <ion-title>
+ *     Page Title
+ *   </ion-title>
+ *
+ *   <ion-buttons>
+ *     <button (click)="openModal()">
+ *       Modal
+ *     </button>
+ *   </ion-buttons>
+ * </ion-navbar>
+ * ```
+ *
  * @see {@link ../../toolbar/Toolbar/ Toolbar API Docs}
  */
 @Component({