Uncaught TypeError: Cannot read property 'names' of undefined about docma

[onury]

Language	Linter	Rule	VSCode
JavaScript	ESLint	valid-jsdoc	extension
TypeScript	TSLint	jsdoc-format	extension

I use VSCode for editor and use/install proper extensions for linting while I write.

I include .eslintrc.json or tslint.json with the project's root. In the npm scripts section of the package.json, I make sure also my build command is preceded with the proper lint command.

[onury]

Thanks for reporting.

Well that's actually invalid JSDoc but still we should watch for it. But shouldn't give warnings which would bloat the code too much. It'd be best to validate/lint jsdoc while writing it (via editors, plugins, etc) anyway..

I'm adding conditionals to watch out for this. I'll let you know shortly.

[dannyrb]

I'm able to fix this issue by doing a find and replace for all instances of:

find:
@returns Object

replace:
@returns {Object}

We should probably emit a warning if no type is specified for @returns?

[dannyrb]

@onury, out of curiosity, what does your typical dev setup look like for enforcing valid JSDoc?

[onury]

Fixed with Docma v3.0.0.