As of eslint-plugin-jsdoc v44.0.0 (ref. #441) the rule informative-docs is available to improve documentation. The rule disallows documentation that effectively just repeats the name of the thing it's documenting because in that case the documentation doesn't add anything (i.e., isn't informative).
At this time the rule is disabled because there's too many violations (~60) and fixing them is non-trivial. This issue exists as an effort to move towards having only informative documentation and enabling the rule to ensure that's the case going forward.
Description
As of
eslint-plugin-jsdoc
v44.0.0 (ref. #441) the ruleinformative-docs
is available to improve documentation. The rule disallows documentation that effectively just repeats the name of the thing it's documenting because in that case the documentation doesn't add anything (i.e., isn't informative).At this time the rule is disabled because there's too many violations (~60) and fixing them is non-trivial. This issue exists as an effort to move towards having only informative documentation and enabling the rule to ensure that's the case going forward.
The suggested configuration would be: