require-meta-docs-description.md

require rules to implement a meta.docs.description property (require-meta-docs-description)

Defining a clear and consistent description for each rule helps developers understand what they're used for.

In particular, each rule description should begin with an allowed prefix:

• enforce
• require
• disallow

Rule Details

This rule requires ESLint rules to have a valid meta.docs.description property.

Examples of incorrect code for this rule:

/* eslint eslint-plugin/require-meta-docs-description: error */
module.exports = {
    meta: {},
    create: function(context) { /* ... */}
};

module.exports = {
    meta: { description: 'this rule does ...' }, // missing allowed prefix
    create: function(context) { /* ... */}
};

Examples of correct code for this rule:

/* eslint eslint-plugin/require-meta-docs-description: error */
module.exports = {
    meta: { description: 'disallow unused variables' },
    create: function(context) { /* ... */}
};

Options

This rule takes an optional object containing:

• String — pattern — A regular expression that the description must match. Use '.+' to allow anything. Defaults to ^(enforce|require|disallow).

Further Reading

• working-with-rules#options-schemas