diff --git a/js/ext/angular/src/directive/ionicBar.js b/js/ext/angular/src/directive/ionicBar.js
index c976b7aaf9..1cfd765d41 100644
--- a/js/ext/angular/src/directive/ionicBar.js
+++ b/js/ext/angular/src/directive/ionicBar.js
@@ -15,6 +15,9 @@ angular.module('ionic.ui.header', ['ngAnimate', 'ngSanitize'])
  * @description
  * Adds a fixed header bar above some content.
  *
+ * Can also be a subheader (lower down) if the 'bar-subheader' class is applied.
+ * See [the header CSS docs](/docs/components/#subheader).
+ *
  * @param {string=} align-title Where to align the title.
  * Avaialble: 'left', 'right', or 'center'.  Defaults to 'center'.
  *
@@ -45,6 +48,9 @@ angular.module('ionic.ui.header', ['ngAnimate', 'ngSanitize'])
  * @description
  * Adds a fixed footer bar below some content.
  *
+ * Can also be a subfooter (higher up) if the 'bar-subfooter' class is applied.
+ * See [the footer CSS docs](/docs/components/#footer).
+ *
  * @param {string=} align-title Where to align the title.
  * Avaialble: 'left', 'right', or 'center'.  Defaults to 'center'.
  *