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

Question

我最近开始在我的角度应用程序中使用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

P.S .: 我一直在寻找更好的@ngdoc类型。如果我们可以使用@ngdoc config或@ngdoc run，我会更喜欢它，但到目前为止，我还没有发现它们是有效的类型。