New linter rules erase some JSDoc formatting

[andretchen0]

Problem

A linter rule added in #388 erases valid Markdown.

Italics

This is an italicized word in valid Markdown in a JSDoc.

/**
 * *italic*
 **/

Linted:

/**
 * italic*
 **/

Bulleted lists

This is a bulleted list in valid Markdown in a JSDoc.

/**
 * * list item 1
 * * list item 2
 * * list item 3
 **/

Linted:

/**
 * list item 1
 * list item 2
 * list item 3
 **/

Solution

• Change this setting: "jsdoc/no-multi-asterisks": ["error"|"warn", {"allowWhitespace":true}]
• Revert the incorrectly linted changes.

See also

• https://github.com/gajus/eslint-plugin-jsdoc/issues/773
• https://github.com/gajus/eslint-plugin-jsdoc/issues/803

Steps to reproduce

• Add this to a Cientos component:

/**
 * * list item 1
 * * list item 2
 * * list item 3
 **/
interface List {}

• Save
• Run pnpm run lint --fix
• The result will be:

/**
 * list item 1
 * list item 2
 * list item 3
 **/
interface List {}

Code of Conduct

• [X] I agree to follow this project's Code of Conduct
• [X] Read the Contributing Guidelines.
• [X] Read the docs.
• [X] Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.
• [X] The provided reproduction is a minimal reproducible example of the bug.

[alvarosabu]

Hi @andretchen0 thanks for raising this, we could change this setting directly on https://github.com/Tresjs/eslint-config so the whole ecosystem is protected against the issue, wdyt?

[andretchen0]

Hi @andretchen0 thanks for raising this, we could change this setting directly on https://github.com/Tresjs/eslint-config so the whole ecosystem is protected against the issue, wdyt?

Sounds good.