useConsistentGraphqlDescriptions

GraphQL

Summary

Rule available since: v2.3.6
Diagnostic Category: lint/nursery/useConsistentGraphqlDescriptions
This rule doesn’t have a fix.
The default severity of this rule is information.
Sources:
- Same as @graphql-eslint/description-style

How to configure

1
{
2
  "linter": {
3
    "rules": {
4
      "nursery": {
5
        "useConsistentGraphqlDescriptions": "error"
6
      }
7
    }
8
  }
9
}

Description

Require all descriptions to follow the same style (either block or inline) to maintain consistency and improve readability across the schema.

Examples

style: `block`

Invalid

1
enum EnumValue {
2
  "this is a description"
3
  DEFAULT
4
}

code-block.graphql:2:3 lint/nursery/useConsistentGraphqlDescriptions ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ℹ Unexpected inline description style.
  
    1 │ enum EnumValue {
  > 2 │   “this is a description”
      │   ^^^^^^^^^^^^^^^^^^^^^^^
    3 │   DEFAULT
    4 │ }
  
  ℹ To stay consistent within the project, write the description block style.
  
  ℹ This rule belongs to the nursery group, which means it is not yet stable and may change in the future. Visit https://biomejs.dev/linter/#nursery for more information.

Valid

1
enum EnumValue {
2
  """
3
  this is a description
4
  """
5
  DEFAULT
6
}

Options

`style`

This option will specify the description style.

"block": Requires triple-quoted block descriptions ("""...""")
"inline": Requires single-quoted inline descriptions ("...")

Default "block"

1
{
2
  "linter": {
3
    "rules": {
4
      "nursery": {
5
        "useConsistentGraphqlDescriptions": {
6
          "options": {
7
            "style": "inline"
8
          }
9
        }
10
      }
11
    }
12
  }
13
}

1
enum EnumValue {
2
  """
3
  this is a description
4
  """
5
  DEFAULT
6
}