diff --git a/ionic/components/menu/menu-close.ts b/ionic/components/menu/menu-close.ts
index b8ffea7760..775a399b2c 100644
--- a/ionic/components/menu/menu-close.ts
+++ b/ionic/components/menu/menu-close.ts
@@ -6,10 +6,12 @@ import {MenuController} from './menu-controller';
 /**
  * @name MenuClose
  * @description
- * The `menuClose` directive can be placed on any button to
- * automatically close an open menu.
+ * The `menuClose` directive can be placed on any button to close an open menu.
  *
  * @usage
+ *
+ * A simple `menuClose` button can be added using the following markup:
+ *
  * ```html
  * <button menuClose>Close Menu</button>
  * ```
diff --git a/ionic/components/menu/menu-toggle.ts b/ionic/components/menu/menu-toggle.ts
index f90a2bca3e..c1ffd4928f 100644
--- a/ionic/components/menu/menu-toggle.ts
+++ b/ionic/components/menu/menu-toggle.ts
@@ -7,10 +7,16 @@ import {MenuController} from './menu-controller';
 /**
  * @name MenuToggle
  * @description
- * The `menuToggle` directive can be placed on any button to
- * automatically close an open menu.
+ * The `menuToggle` directive can be placed on any button to toggle a menu open or closed.
+ * If it is added to the [NavBar](../../nav/NavBar) of a page, the button will only appear
+ * when the page it's in is currently a root page. See the [Menu Navigation Bar Behavior](../Menu#navigation-bar-behavior)
+ * docs for more information.
+ *
  *
  * @usage
+ *
+ * A simple `menuToggle` button can be added using the following markup:
+ *
  * ```html
  * <button menuToggle>Toggle Menu</button>
  * ```
diff --git a/ionic/components/menu/menu.ts b/ionic/components/menu/menu.ts
index e83a4b6cd4..ca97332994 100644
--- a/ionic/components/menu/menu.ts
+++ b/ionic/components/menu/menu.ts
@@ -44,8 +44,8 @@ import {isTrueProperty} from '../../util/util';
  *
  * If a [MenuToggle](../MenuToggle) button is added to the [NavBar](../../nav/NavBar) of
  * a page, the button will only appear when the page it's in is currently a root page. The
- * root page is the initial page loaded in the app, or it can be set using the [setRoot](../../nav/NavController/#setRoot)
- * method on the [NavController](../../nav/NavController).
+ * root page is the initial page loaded in the app, or a page that has been set as the root
+ * using the [setRoot](../../nav/NavController/#setRoot) method on the [NavController](../../nav/NavController).
  *
  * For example, say the application has two pages, `Page1` and `Page2`, and both have a
  * `MenuToggle` button in their navigation bars. Assume the initial page loaded into the app