Derzeit verwenden wir in meinem Projekt JSDoc. Wir haben kürzlich mit der Implementierung von Angular begonnen, und ich möchte JSDoc weiterhin verwenden, um sicherzustellen, dass sich die gesamte Dokumentation an derselben Stelle befindet.

Ich habe mir die Leute angesehen, die hauptsächlich gesagt haben, dass sie ngDoc verwenden sollen, aber dies ist keine praktikable Option, da wir immer ein separates JavaScript haben und ich im Idealfall alles zusammen haben würde.

/**
 * @author Example <[email protected]>
 * @copyright 2014 Example Ltd. All rights reserved.
 */
(function () {
    window.example = window.example || {};
    /**
     * Example Namespace
     * @memberOf example
     * @namespace example.angular
     */
    window.example.angular = window.example.angular || {};
    var exAngular = window.example.angular;

    /**
     * A Example Angular Bootstrap Module
     * @module exampleAngularBootstrap
     */
    exAngular.bootstrap = angular.module('exampleAngularBootstrap', [
            'ngRoute',
            'ngResource',
            'ngCookies'
        ])
        .run(function ($http, $cookies) {
            $http.defaults.headers.post['X-CSRFToken'] = $cookies.csrftoken;
            $http.defaults.headers.common['X-CSRFToken'] = $cookies.csrftoken;
        });
})();

Momentan ist dies das, was ich habe, aber ich kann keine Dokumentation für run () erstellen.