docs: function(scope, element) {
  
  
          //handle special-case directives that don't follow a (DOM hierarchy <=> Scope hierarchy) relationship
          if(element){
            var SPECIAL_CASE_LIST = ['fa-edge-swapper', 'fa-render-controller', 'fa-deck', 'fa-light-box'];
            var special = false;
            angular.forEach(SPECIAL_CASE_LIST, function(specialCase){
              if(specialCase.toUpperCase() === element[0].tagName) { special = true; return; }
              if(element[0].attributes[specialCase] !== undefined) { special = true; return; }
            });
            if(special){
              scope = scope.$parent;
            }
          }
  
          scope.isolate = scope.isolate || {};
          scope.isolate[scope.$id] = scope.isolate[scope.$id] || {};
  
          //assign the scope $id to the isolate
          var isolate = scope.isolate[scope.$id];
          isolate.id = scope.$id;
  
          //assign default ng-repeat index if it exists
          //and index isn't already assigned
          var i = scope.$eval("$index");
          if(i && i !== '$index' && !isolate.index) isolate.index = i;
  
          _isolateStore[isolate.id] = isolate;
  
          return isolate;
        }