sindresorhus/eslint-plugin-unicorn
Rule proposal: Doc comment asterisk prefix style
Geschlossen
#1.607 geöffnet am 11.11.2021
help wantednew rule
Repository-Metriken
- Stars
- (5.022 Sterne)
- PR-Merge-Metriken
- (Durchschn. Merge 1T 16h) (399 gemergte PRs in 30 T)
Beschreibung
Description
I prefer not using asterisk prefix on doc comments as I find them noisy and they also make it much harder to edit comments.
I'm aware you can almost get this with the JSDoc ESLint plugin, but it's a bit heavy to add that just for this and doc comments do not necessarily need to be JSDoc, so this rule would be more general.
Fail
/**
* Add two numbers.
* @param {number} num1 The first number.
* @param {number} num2 The second number.
* @returns {number} The sum of the two numbers.
*/
Pass
/**
Add two numbers.
@param {number} num1 The first number.
@param {number} num2 The second number.
@returns {number} The sum of the two numbers.
*/
(Notice how */ moved too)