jsdoc/require-property-description 正しさ
何をするか
すべての @property タグに説明文が必須であることを要求します。
なぜ悪いのか
プロパティの説明はドキュメント化されるべきです。
例
このルールに対して誤りなコードの例:
javascript
/**
* @typedef {SomeType} SomeTypedef
* @property {number} foo
*/このルールに対して正しいコードの例:
javascript
/**
* @typedef {SomeType} SomeTypedef
* @property {number} foo Foo.
*/使い方
設定ファイルまたは CLI でこのルールを有効化するには、以下のように使用できます:
json
{
"plugins": ["jsdoc"],
"rules": {
"jsdoc/require-property-description": "error"
}
}bash
oxlint --deny jsdoc/require-property-description --jsdoc-plugin