@@ -25,7 +25,15 @@ export function getJsdocConfigs({files, tsFiles}) {
2525 rules : {
2626 // Validation
2727 'jsdoc/check-access' : 'error' ,
28- 'jsdoc/check-alignment' : 'error' ,
28+
29+ // Doesn't work when not prefixing lines with `*`.
30+ // 'jsdoc/check-alignment': [
31+ // 'error',
32+ // {
33+ // innerIndent: 0,
34+ // }
35+ // ],
36+
2937 'jsdoc/check-indentation' : 'error' ,
3038 'jsdoc/check-line-alignment' : 'error' ,
3139 'jsdoc/check-param-names' : 'error' ,
@@ -49,7 +57,14 @@ export function getJsdocConfigs({files, tsFiles}) {
4957 'jsdoc/convert-to-jsdoc-comments' : 'off' ,
5058 'jsdoc/empty-tags' : 'error' ,
5159 'jsdoc/escape-inline-tags' : 'error' ,
52- 'jsdoc/lines-before-block' : 'error' ,
60+
61+ // The rule is dumb and doesn't handle:
62+ // export type Options = {
63+ // /**
64+ // Foo
65+ // */
66+ // 'jsdoc/lines-before-block': 'error',
67+
5368 'jsdoc/multiline-blocks' : 'error' ,
5469 'jsdoc/no-bad-blocks' : 'error' ,
5570 'jsdoc/no-blank-block-descriptions' : 'error' ,
@@ -60,7 +75,7 @@ export function getJsdocConfigs({files, tsFiles}) {
6075 'never' ,
6176 ] ,
6277 'jsdoc/sort-tags' : 'off' , // Too opinionated. Too much churn.
63- 'jsdoc/tag-lines' : 'error' ,
78+ 'jsdoc/tag-lines' : [ 'error' , 'any' , { startLines : null } ] ,
6479 'jsdoc/type-formatting' : 'off' , // It's marked as experimental.
6580
6681 // Content
@@ -86,7 +101,11 @@ export function getJsdocConfigs({files, tsFiles}) {
86101 // Requirements — these only apply to existing JSDoc comments,
87102 // except `require-jsdoc` which requires JSDoc to be present.
88103 'jsdoc/require-description' : 'error' ,
89- 'jsdoc/require-description-complete-sentence' : 'error' ,
104+
105+ // It's too naive. Requires dot at the end here:
106+ // Modifier: Make the text italic. *(Not widely supported)*
107+ // 'jsdoc/require-description-complete-sentence': 'error',
108+
90109 'jsdoc/require-example' : 'off' ,
91110 'jsdoc/require-file-overview' : 'off' ,
92111 'jsdoc/require-hyphen-before-param-description' : 'off' ,
0 commit comments