diff --git a/.README/rules/informative-docs.md b/.README/rules/informative-docs.md index 90420a5a4..1c9234425 100644 --- a/.README/rules/informative-docs.md +++ b/.README/rules/informative-docs.md @@ -35,6 +35,20 @@ The default `aliases` option is: } ``` +### `excludedTags` + +Tags that should not be checked for valid contents. + +For example, with `{ excludedTags: ["category"] }`, the following comment would not be considered uninformative: + +```js +/** @category Types */ +function computeTypes(node) { + // ... +} + +No tags are excluded by default. + ### `uselessWords` Words that are ignored when searching for one that adds meaning. diff --git a/docs/rules/informative-docs.md b/docs/rules/informative-docs.md index 027d4e1fa..60eaf3204 100644 --- a/docs/rules/informative-docs.md +++ b/docs/rules/informative-docs.md @@ -47,6 +47,22 @@ The default `aliases` option is: } ``` + + +### excludedTags + +Tags that should not be checked for valid contents. + +For example, with `{ excludedTags: ["category"] }`, the following comment would not be considered uninformative: + +```js +/** @category Types */ +function computeTypes(node) { + // ... +} + +No tags are excluded by default. + ### uselessWords