diff --git a/src/state.js b/src/state.js
index 0ab449ec7..a80b2a641 100644
--- a/src/state.js
+++ b/src/state.js
@@ -1010,11 +1010,12 @@ function $StateProvider(   $urlRouterProvider,   $urlMatcherFactory) {
      * @methodOf ui.router.state.$state
      *
      * @description
-     * A method to determine if the current active state is equal to or is the child of the 
+     * A method to determine if the current active state is equal to or is the child of the
      * state stateName. If any params are passed then they will be tested for a match as well.
      * Not all the parameters need to be passed, just the ones you'd like to test for equality.
      *
      * @example
+     * Partial and relative names
      * <pre>
      * $state.$current.name = 'contacts.details.item';
      *
@@ -1028,13 +1029,9 @@ function $StateProvider(   $urlRouterProvider,   $urlMatcherFactory) {
      * // Using relative names (. and ^), typically from a template
      * // E.g. from the 'contacts.details' template
      * <div ng-class="{highlighted: $state.includes('.item')}">Item</div>
-     *
      * </pre>
      *
-     * @description
-     * Basic globbing patterns will also work.
-     *
-     * @example
+     * Basic globbing patterns
      * <pre>
      * $state.$current.name = 'contacts.details.item.url';
      *
@@ -1049,7 +1046,7 @@ function $StateProvider(   $urlRouterProvider,   $urlMatcherFactory) {
      *
      * @param {string} stateOrName A partial name, relative name, or glob pattern
      * to be searched for within the current state name.
-     * @param {object} params A param object, e.g. `{sectionId: section.id}`, 
+     * @param {object} params A param object, e.g. `{sectionId: section.id}`,
      * that you'd like to test against the current active state.
      * @returns {boolean} Returns true if it does include the state
      */