diff --git a/js/angular/directive/tabs.js b/js/angular/directive/tabs.js
index aa14569ada..aa18c996c5 100644
--- a/js/angular/directive/tabs.js
+++ b/js/angular/directive/tabs.js
@@ -18,6 +18,9 @@
  * See the {@link ionic.directive:ionTab} directive's documentation for more details on
  * individual tabs.
  *
+ * Note: do not place ion-tabs inside of an ion-content element; it has been known to cause a
+ * certain CSS bug.
+ *
  * @usage
  * ```html
  * <ion-tabs class="tabs-positive tabs-icon-only">