gulp-apidoc 
Generates a RESTful web API Documentation. Documentation at apidocjs.com
Uses the apidoc library.
/path/api/stuff.js:
/** * @api {get} /user/:id Request User information * @apiName GetUser * @apiGroup User * * @apiParam {Number} id Users unique ID. * * @apiSuccess {String} firstname Firstname of the User. * @apiSuccess {String} lastname Lastname of the User. */Install with npm
npm install --save-dev gulp-apidoc var gulp = require('gulp'), apidoc = require('gulp-apidoc'); gulp.task('apidoc', function(done){ apidoc({ src: "example/", dest: "build/" },done); });With options:
var gulp = require('gulp'), apidoc = require('gulp-apidoc'); gulp.task('apidoc',function(done){ apidoc({ src: "example/", dest: "build/", template: "template/", debug: true, includeFilters: [ ".*\\.js$" ] },done); });Other options checkout.
Type: String
Type: String Default: doc/
Type: String
Type: String Default: options.src
Type: Boolean Default: false
Type: Boolean Default: false
Type: Boolean Default: false
Type: Boolean Default: false
Type: Array Default: []