A doc gen command-line tool and library which dumps block comments in a javascript project to a docs directory of the same structure.

...as a gulp plugin:

$ npm install --save-dev justdoc

...as a command-line tool:

$ npm install -g justdoc

In your gulpfile

var justdoc = require('justdoc');

gulp.task('doc', function () {
	gulp.src('src/**/*.js')
	.pipe(justdoc())
	.pipe(gulp.dest('docs'));
});

$ justdoc

  Usage: justdoc [options] <SourcePath> <DestPath>

  Options:

    -h, --help                output usage information
    -V, --version             output the version number
    -e, --ext <Extension>     file extension of doc files (default is 'md')
    -i, --input <SourcePath>  path to source directory (default is current directory)
    -o, --output <DestPath>   path to generate new docs directory (default is 'docs')
    -g, --glob <Glob>         provide custom glob (default is '**/*.js')

Use the justdoc command to generate docs from a source path, and output them to a destination path:

$ justdoc ./src ./docs

justdoc assumes markdown, but you specify any extension and use whatever doc format you want:

$ justdoc -e txt ./src ./docs

justdoc parses your javascript source files for block comments and pulls out those that start with the equal sign =:

/*=
## function - getData()
returns the component data
*/

If the comment doesn't start with = then it won't be included in the doc output.

The first line can also be used to tell justdoc to ignore the beginning few character of each line. For example, if you want to start evey line with * (space+asterisk+space), simply place them after the = so that justdoc ignores the leading characters.

/*= * 
 * ## function - getData()
 * returns the component data
 */

This pattern will work with any string of characters (even spaces and tabs). Useful for trimming or padding your comments without affecting the doc output.