Name inference repeatedly documents the same items about gulp-documentation HOT 8 CLOSED

Retitled to something actionable; appreciate the attempt at humor (sarcasm?) but to stay sane and productive we should focus on actionable issues.

Does jsdoc provide correct output? Can you provide an example of the code you're documenting so that we can determine where the issue lies?

from gulp-documentation.

This is one small module:

/**
 * This is the entry point for the admin interface
 * 
 * @namespace Index
 * @param  {String}
 * @return {Object} Exports object
 */
var Index = (function () {
    var _name = 'Project name';

    /**
     * Initialize application
     * @memberOf Index
     * @return {void}
     */
    function init () {
        var dashboard = require('dashboard');

        // Set initial Document Title to the name of the app
        document.title = _name;

        addEventListeners();
    }

    /**
     * This is left blank intentionally
     * @memberOf Index
     */
    function addEventListeners () {}

    /**
     * Initialize module Index internally
     */
    init();
}());

module.exports = Index;

All other modules are based on the same syntax.

from gulp-documentation.

It outputs a directory called 'assets' and an index.html file. In the assets directory I find these files:

anchor.js
bass.css
github.css
site.js
style.css

If that is what it's supposed to output then I guess it does provide correct output.

from gulp-documentation.

Can you try changing @memberOf Index to @memberof Index? The memberof tag, like all other JSDoc tags, is all lowercase.

from gulp-documentation.

OK, that made something of a difference. Am I wrong if I think that it used to be with a capital O?

Well, I guess I'll walk over all the syntax again ... thanks for pointing that out.

from gulp-documentation.

I don't believe so, in 2012, before the site moved to usejsdoc.org, it was all lowercase commit

from gulp-documentation.

Yeah, but I'm using DocBlockr in Sublime Text 2 / 3 and there it is @memberof. Even google code has it referenced with an uppercase o:
https://code.google.com/archive/p/jsdoc-toolkit/wikis/TagReference.wiki

Don't know what's going on. It used to work fine with the original gulp-jsdoc with an upper o. I've opened a ticket, asking them to change it to a lower case. We'll see if that will happen. In ST 2 I can change the bugger myself. But due to the change in how packages are managed in ST 3 I can do nothing but wait for 'someone' to do 'something'. That's one of the cons of depending on other peoples code ... I guess it wouldn't make any sense for you to go .toLowerCase() on all @NAMEs in gulp-documentation?

from gulp-documentation.

SOLUTION FOUND: In case any other poor soul is looking for a solution to this:
Install PackageResourceViewer for ST3, and voila, edit the resource yourself.

https://github.com/skuroda/PackageResourceViewer

from gulp-documentation.