diff --git a/js/angular/directive/navButtons.js b/js/angular/directive/navButtons.js
index 2cfc12585f..319f5f3e9b 100644
--- a/js/angular/directive/navButtons.js
+++ b/js/angular/directive/navButtons.js
@@ -23,6 +23,8 @@
  * example, a toggle button for a left side menu should be on the left side, in this case
  * we'd recommend uses `side="left"` so it's always on the left, no matter what platform.
  *
+ * Note that the `ion-nav-buttons` must be an immediate descendant of the `ion-view` element.
+ *
  * @usage
  * ```html
  * <ion-nav-bar>