how do i run for all my files? about gulp-documentation HOT 6 CLOSED

Sure, I'm updating this module to documentation v4 and updating the readme with a multi-file example.

from gulp-documentation.

It seems your documentation should be updated. When I use

gulp.task('documentation', function() {
    gulp.src('app/js/**/*.js')
        .pipe(gulpDocumentation({
            format: 'html'
        }))
        .pipe(gulp.dest('docs/api'));
});

I get the following error:

[10:59:38] Error: invalid format given: valid options are html, md, remark, json
    at module.exports (/…/…/Workspace/pm-wg-angular/node_modules/gulp-documentation/index.js:82:11)
    …

from gulp-documentation.

And it works only, when the task returns the stream. Otherwise no output is generated ;(

from gulp-documentation.

Hi @rwam - the recent version bump to 3.0.0 included a breaking change, along with updated examples. To update to 3.0.0, your code would look like:

gulp.task('documentation', function() {
    gulp.src('app/js/**/*.js')
        .pipe(gulpDocumentation('html'))
        .pipe(gulp.dest('docs/api'));
});

That that modified version out and let me know if it still doesn't work with the change.

from gulp-documentation.

Hi @tmcw – I use version 3.0.0 and yes I tried it as described. But it only write it on the output directory when I use a return statement:

gulp.task('documentation', function() {
    return gulp.src('app/js/**/*.js')
        .pipe(gulpDocumentation('html'))
        .pipe(gulp.dest('docs/api'));
});

Ok I see the info on the 3.0.0 tag is actual, but it's a little weird ;) There is a missing character:

from gulp-documentation.

Thanks for spotting that! I've updated the code examples so they should be functional.

from gulp-documentation.