feat: no-multi-asterisks rule to prevent multiple asterisks with mi…

…ddle delimiters or at end of blocks

.README/README.md

@@ -557,6 +557,7 @@ selector).
 {"gitdown": "include", "file": "./rules/no-bad-blocks.md"}
 {"gitdown": "include", "file": "./rules/no-defaults.md"}
 {"gitdown": "include", "file": "./rules/no-missing-syntax.md"}
+{"gitdown": "include", "file": "./rules/no-multi-asterisks.md"}
 {"gitdown": "include", "file": "./rules/no-restricted-syntax.md"}
 {"gitdown": "include", "file": "./rules/no-types.md"}
 {"gitdown": "include", "file": "./rules/no-undefined-types.md"}

.README/rules/no-multi-asterisks.md

@@ -0,0 +1,41 @@
+### `no-multi-asterisks`
+
+Prevents use of multiple asterisks at the beginning of lines.
+
+Note that if you wish to prevent multiple asterisks at the very beginning of
+the jsdoc block, you should use `no-bad-blocks` (as that is not proper jsdoc
+and that rule is for catching blocks which only seem like jsdoc).
+
+#### Options
+
+##### `preventAtMiddleLines` (defaults to `true`)
+
+Prevent the likes of this:
+
+```js
+/**
+ *
+ **
+ */
+```
+
+##### `preventAtEnd` (defaults to `true`)
+
+Prevent the likes of this:
+
+```js
+/**
+ *
+ *
+ **/
+```
+
+|||
+|---|---|
+|Context|everywhere|
+|Tags|(any)|
+|Recommended|true|
+|Settings||
+|Options|`preventAtEnd`, `preventAtMiddleLines`|
+
+<!-- assertions noMultiAsterisks -->