tsdoc
TSDoc-focused preset with function/type-parameter requirements and compatibility-tag restrictions.
What this preset is forâ
Use tsdoc when you want a strong TSDoc baseline with both required content and vocabulary controls.
This preset works well for:
- TypeScript library APIs
- SDKs with strict documentation standards
- teams standardizing on TSDoc over mixed JSDoc/TypeDoc conventions
What this preset enablesâ
tsdoc-require-2/requiretsdoc-require-2/require-remarkstsdoc-require-2/require-paramwithenforceFor: ["function"]tsdoc-require-2/require-returnswithenforceFor: ["function"]tsdoc-require-2/require-throwswithenforceFor: ["function"]tsdoc-require-2/require-type-paramwithenforceFor: ["class", "function", "interface", "type"]tsdoc-require-2/restrict-tagsin deny mode for TypeDoc compatibility tags
Why this preset is different from jsdocâ
jsdoc focuses on function tags only. tsdoc adds stronger TSDoc structure (@remarks, @typeParam) and stricter tag vocabulary.
Config keyâ
tsdocRequire.configs.tsdoc
Flat Config exampleâ
import tsdocRequire from "eslint-plugin-tsdoc-require-2";
export default [tsdocRequire.configs.tsdoc];
Common customizationâ
If your docs intentionally use some TypeDoc tags, override restrict-tags.tags instead of disabling restrict-tags entirely.