clarify what is valid jsdoc => canonical jsdoc

configs/basic.js

@@ -372,7 +372,43 @@ module.exports = {
     'template-tag-spacing': ['error', 'never'],
     'unicode-bom': 'error',
     'use-isnan': 'error',
-    'valid-jsdoc': 'error',
+    'valid-jsdoc': ['error', {
+      prefer: {
+        // no synonyms
+        arg: 'param',
+        argument: 'param',
+        const: 'constant',
+        defaultvalue: 'default',
+        desc: 'description',
+        emits: 'fires',
+        exception: 'throws',
+        extends: 'augments',
+        fileoverview: 'file',
+        func: 'function',
+        host: 'external',
+        method: 'function',
+        overview: 'file',
+        return: 'returns',
+        var: 'member',
+        virtual: 'abstract',
+        yield: 'yields'
+      },
+      preferType: {
+        BigInt: 'bigint',
+        Boolean: 'boolean',
+        Null: 'null',
+        Number: 'number',
+        String: 'string',
+        Symbol: 'symbol',
+        Undefined: 'undefined',
+        Void: 'void',
+        array: 'Array',
+        function: 'Function',
+        object: 'Object'
+      },
+      requireParamDescription: false,
+      requireReturnDescription: false
+    }],
     'valid-typeof': 'error',
     'vars-on-top': 'error',
     'wrap-iife': ['error', 'inside'],