Add meta.docs.description to all rules

lib/rules/handle-done-callback.js

@@ -5,7 +5,10 @@ const astUtils = require('../util/ast');
 
 module.exports = {
     meta: {
-        type: 'problem'
+        type: 'problem',
+        docs: {
+            description: 'Enforces handling of callbacks for async tests'
+        }
     },
     create(context) {
         function isAsyncFunction(functionExpression) {

lib/rules/max-top-level-suites.js

@@ -18,6 +18,9 @@ function isTopLevelScope(scope) {
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Limit the number of top-level suites in a single file'
+        },
         schema: [
             {
                 type: 'object',

lib/rules/no-async-describe.js

@@ -12,6 +12,9 @@ const { additionalSuiteNames } = require('../util/settings');
 module.exports = {
     meta: {
         type: 'problem',
+        docs: {
+            description: 'Disallow async functions passed to describe'
+        },
         fixable: 'code'
     },
     create(context) {

lib/rules/no-exclusive-tests.js

@@ -5,7 +5,10 @@ const astUtils = require('../util/ast');
 
 module.exports = {
     meta: {
-        type: 'problem'
+        type: 'problem',
+        docs: {
+            description: 'Disallow exclusive tests'
+        }
     },
     create(context) {
         let mochaTestFunctions = [

lib/rules/no-global-tests.js

@@ -4,7 +4,10 @@ const astUtils = require('../util/ast');
 
 module.exports = {
     meta: {
-        type: 'suggestion'
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow global tests'
+        }
     },
     create(context) {
         function isGlobalScope(scope) {

lib/rules/no-hooks-for-single-case.js

@@ -14,6 +14,9 @@ function newDescribeLayer(describeNode) {
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Disallow hooks for a single test or test suite'
+        },
         schema: [
             {
                 type: 'object',

lib/rules/no-hooks.js

@@ -5,6 +5,9 @@ const astUtil = require('../util/ast');
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Disallow hooks'
+        },
         schema: [
             {
                 type: 'object',

lib/rules/no-identical-title.js

@@ -43,7 +43,10 @@ function isFirstArgLiteral(node) {
 
 module.exports = {
     meta: {
-        type: 'suggestion'
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow identical titles'
+        }
     },
     create(context) {
         const titleLayers = [ newLayer() ];

lib/rules/no-mocha-arrows.js

@@ -10,6 +10,9 @@ const astUtils = require('../util/ast');
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Disallow arrow functions as arguments to mocha functions'
+        },
         fixable: 'code'
     },
     create(context) {

lib/rules/no-nested-tests.js

@@ -7,7 +7,10 @@ const { additionalSuiteNames } = require('../util/settings');
 
 module.exports = {
     meta: {
-        type: 'problem'
+        type: 'problem',
+        docs: {
+            description: 'Disallow tests to be nested within other tests '
+        }
     },
     create(context) {
         const settings = context.settings;

lib/rules/no-pending-tests.js

@@ -4,7 +4,10 @@ const astUtils = require('../util/ast');
 
 module.exports = {
     meta: {
-        type: 'suggestion'
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow pending tests'
+        }
     },
     create(context) {
         function isPendingMochaTest(node) {

lib/rules/no-return-and-callback.js

@@ -41,7 +41,10 @@ function reportIfFunctionWithBlock(context, node, doneName) {
 
 module.exports = {
     meta: {
-        type: 'problem'
+        type: 'problem',
+        docs: {
+            description: 'Disallow returning in a test or hook function that uses a callback'
+        }
     },
     create(context) {
         function check(node) {

lib/rules/no-return-from-async.js

@@ -35,7 +35,10 @@ function reportIfFunctionWithBlock(context, node) {
 
 module.exports = {
     meta: {
-        type: 'suggestion'
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow returning from an async test or hook'
+        }
     },
     create(context) {
         function check(node) {

lib/rules/no-setup-in-describe.js

@@ -10,7 +10,10 @@ const PURE = 3;
 
 module.exports = {
     meta: {
-        type: 'suggestion'
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow setup in describe blocks'
+        }
     },
     create(context) {
         const nesting = [];

lib/rules/no-sibling-hooks.js

@@ -15,7 +15,10 @@ function newDescribeLayer(describeNode) {
 
 module.exports = {
     meta: {
-        type: 'suggestion'
+        type: 'suggestion',
+        docs: {
+            description: 'Disallow duplicate uses of a hook at the same level inside a describe'
+        }
     },
     create(context) {
         const isUsed = [];

lib/rules/no-skipped-tests.js

@@ -49,6 +49,9 @@ function isCallToMochaXFunction(callee) {
 module.exports = {
     meta: {
         fixable: 'code',
+        docs: {
+            description: 'Disallow skipped tests'
+        },
         type: 'problem'
     },
     create(context) {

lib/rules/no-synchronous-tests.js

@@ -38,6 +38,9 @@ function doesReturnPromise(functionExpression) {
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Disallow synchronous tests'
+        },
         schema: [
             {
                 type: 'object',

lib/rules/no-top-level-hooks.js

@@ -5,7 +5,10 @@ const { additionalSuiteNames } = require('../util/settings');
 
 module.exports = {
     meta: {
-        type: 'problem'
+        type: 'problem',
+        docs: {
+            description: 'Disallow top-level hooks'
+        }
     },
     create(context) {
         const settings = context.settings;

lib/rules/prefer-arrow-callback.js

@@ -156,7 +156,7 @@ module.exports = {
         type: 'suggestion',
 
         docs: {
-            description: 'require using arrow functions for callbacks',
+            description: 'Require using arrow functions for callbacks',
             category: 'ECMAScript 6',
             recommended: false,
             url: 'https://eslint.org/docs/rules/prefer-arrow-callback'

lib/rules/valid-suite-description.js

@@ -49,6 +49,9 @@ const messageSchema = {
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Match suite descriptions against a pre-configured regular expression'
+        },
         schema: [
             {
                 oneOf: [ patternSchema, {

lib/rules/valid-test-description.js

@@ -48,6 +48,9 @@ const messageSchema = {
 module.exports = {
     meta: {
         type: 'suggestion',
+        docs: {
+            description: 'Match test descriptions against a pre-configured regular expression'
+        },
         schema: [
             {
                 oneOf: [ patternSchema, {