angularjs - ngdocs - 如何记录模块配置和运行块

Question

我最近开始在我的 Angular 应用程序中使用 ngdocs，我对如何合理地记录模块配置和运行块感到困惑。

我目前有这个：

/**
 * @ngdoc overview
 * @name app.core
 * @description
 * # app.core
 * This module defines the core application behaviour such as routing and translation services.
 */
angular.module('app.core', ['pascalprecht.translate',
    'ui.router'
  ])
  .run(['$rootScope', '$state', 'AuthService', function($rootScope, $state, AuthService){
    //How to document this?
    $rootScope.$on('$stateChangeStart', function(event, toState, toParams){
      if(toState.name !== 'login' && !AuthService.isLoggedIn()){
        var requestedState = {
          toState: toState,
          toParams: toParams
        };
        $state.go('login', requestedState);
        event.preventDefault();
      }
    });
  }]);

它按预期在文档中输出模块 app.core 。但是如何记录运行块？我正在努力寻找任何例子。

谢谢

Answer 1

尝试修改@name，即：

* @name app.core.run:AuthService

PS：我一直在寻找更好的@ngdoc 类型。如果我们可以使用@ngdoc configor @ngdoc run，我会更喜欢它，但到目前为止我还没有发现这些是有效的类型。