tsdoc icon indicating copy to clipboard operation
tsdoc copied to clipboard

`eslint-plugin-tsdoc`: Check types referenced through `{@link}` and `{@inheritDoc}`

Open kraenhansen opened this issue 1 year ago • 0 comments

In its current form, the plugin doesn't supply a rule to check the types referenced from an inline link or inheritDoc tag.

This means that it's harder for maintainers of documentation to notice when these break due to a rename of some referenced type.

I suggest adding a new rule named check-types or valid-types (as a homage to eslint-plugin-jsdoc's rule of the same name) which would check that the type referenced is in scope of the comment.

Note: Enabling this rule, could potentially also mark the types as used and fix https://github.com/microsoft/tsdoc/issues/348 too.

I'd be interested in submitting a PR for this, if this is interesting for the maintainers.

kraenhansen avatar May 04 '23 18:05 kraenhansen