7
Mam projekt Backbone boilerplate opartego, że chcę, aby dokument z niedawnym jdoc-toolkitJak mogę udokumentować AMD projekt + szkieletowej z JSDoc3
Chociaż nie mogę zmusić go do wygenerowania niczego poza pustym _global klasy
przykładowy kod:
/**
* This is a root model for DLClass
* @module models/DLClass
*/
define([
'underscore',
'backbone'
], /** @lends DLClass */ function (_, Backbone) {
/**
* This is a root model for DLClass
* @class DLClass
* @constructor
* @return Session Object
*/
var DLModel = Backbone.Model.extend({
/** @lends DLClass.prototype */
/**
* Generic tap event
* @param touchEvent
*/
onTap: function (touchEvent) {
},
Nie możesz rozważyć to strasznie pomocny sugestia, ale może warto rozważyć, że można uzyskać wszystkie lub prawie wszystkie z pożądanych korzyści używając tylko JSDoc sposób już jesteś i nigdy generowania plików dokumentacji. Twoi programiści powinni mieć pełną zdolność do czytania dokumentacji wewnątrz plików .js, bez potrzeby generowania kodu HTML, przez co całkowicie unikniesz problemu z tym pytaniem. – machineghost