@graphql-eslint/eslint-plugin 3.0.0-alpha-069461d.0 → 3.0.0-alpha-698204a.0

package/docs/rules/known-fragment-names.md

@@ -1,8 +1,8 @@
 # `known-fragment-names`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/known-fragment-names`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/known-type-names.md

@@ -1,8 +1,8 @@
 # `known-type-names`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` and `"plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Schema & Operations`
 - Rule name: `@graphql-eslint/known-type-names`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/lone-anonymous-operation.md

@@ -1,8 +1,8 @@
 # `lone-anonymous-operation`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/lone-anonymous-operation`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/lone-schema-definition.md

@@ -1,8 +1,8 @@
 # `lone-schema-definition`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/lone-schema-definition`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/match-document-filename.md

@@ -1,6 +1,6 @@
 # `match-document-filename`
 
-- Category: `Best Practices`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/match-document-filename`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
@@ -88,7 +88,7 @@ query UserById {
 
 The schema defines the following properties:
 
-### `fileExtension` (string, enum)
+### `fileExtension` (enum)
 
 This element must be one of the following enum values:
 
@@ -129,7 +129,7 @@ The object must be one of the following types:
 
 The schema defines the following additional types:
 
-## `asString` (string)
+## `asString` (enum)
 
 One of: `camelCase`, `PascalCase`, `snake_case`, `UPPER_CASE`, `kebab-case`
 
@@ -137,7 +137,7 @@ One of: `camelCase`, `PascalCase`, `snake_case`, `UPPER_CASE`, `kebab-case`
 
 Properties of the `asObject` object:
 
-### `style` (string, enum)
+### `style` (enum)
 
 This element must be one of the following enum values:
 
@@ -147,6 +147,8 @@ This element must be one of the following enum values:
 - `UPPER_CASE`
 - `kebab-case`
 
+### `suffix` (string)
+
 ## Resources
 
 - [Rule source](../../packages/plugin/src/rules/match-document-filename.ts)

package/docs/rules/naming-convention.md

@@ -1,8 +1,8 @@
 # `naming-convention`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` and `"plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Best Practices`
+- Category: `Schema & Operations`
 - Rule name: `@graphql-eslint/naming-convention`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
@@ -39,12 +39,12 @@ The schema defines the following properties:
 
 Includes:
 
-- `ObjectTypeDefinition`
-- `InterfaceTypeDefinition`
-- `EnumTypeDefinition`
-- `ScalarTypeDefinition`
-- `InputObjectTypeDefinition`
-- `UnionTypeDefinition`
+- [ObjectTypeDefinition](https://spec.graphql.org/October2021/#ObjectTypeDefinition)
+- [InterfaceTypeDefinition](https://spec.graphql.org/October2021/#InterfaceTypeDefinition)
+- [EnumTypeDefinition](https://spec.graphql.org/October2021/#EnumTypeDefinition)
+- [ScalarTypeDefinition](https://spec.graphql.org/October2021/#ScalarTypeDefinition)
+- [InputObjectTypeDefinition](https://spec.graphql.org/October2021/#InputObjectTypeDefinition)
+- [UnionTypeDefinition](https://spec.graphql.org/October2021/#UnionTypeDefinition)
 
 The object must be one of the following types:
 
@@ -55,11 +55,10 @@ The object must be one of the following types:
 
 Includes:
 
-- `FieldDefinition`
-- `InputValueDefinition`
-- `VariableDefinition`
-- `Argument`
-- `DirectiveDefinition`
+- [FieldDefinition](https://spec.graphql.org/October2021/#FieldDefinition)
+- [InputValueDefinition](https://spec.graphql.org/October2021/#InputValueDefinition)
+- [Argument](https://spec.graphql.org/October2021/#Argument)
+- [DirectiveDefinition](https://spec.graphql.org/October2021/#DirectiveDefinition)
 
 The object must be one of the following types:
 
@@ -78,20 +77,20 @@ Default: `false`
 
 May contain the following `ASTNode` names:
 
-- `Argument`
-- `DirectiveDefinition`
-- `EnumTypeDefinition`
-- `EnumValueDefinition`
-- `FieldDefinition`
-- `FragmentDefinition`
-- `InputObjectTypeDefinition`
-- `InputValueDefinition`
-- `InterfaceTypeDefinition`
-- `ObjectTypeDefinition`
-- `OperationDefinition`
-- `ScalarTypeDefinition`
-- `UnionTypeDefinition`
-- `VariableDefinition`
+- [Argument](https://spec.graphql.org/October2021/#Argument)
+- [DirectiveDefinition](https://spec.graphql.org/October2021/#DirectiveDefinition)
+- [EnumTypeDefinition](https://spec.graphql.org/October2021/#EnumTypeDefinition)
+- [EnumValueDefinition](https://spec.graphql.org/October2021/#EnumValueDefinition)
+- [FieldDefinition](https://spec.graphql.org/October2021/#FieldDefinition)
+- [FragmentDefinition](https://spec.graphql.org/October2021/#FragmentDefinition)
+- [InputObjectTypeDefinition](https://spec.graphql.org/October2021/#InputObjectTypeDefinition)
+- [InputValueDefinition](https://spec.graphql.org/October2021/#InputValueDefinition)
+- [InterfaceTypeDefinition](https://spec.graphql.org/October2021/#InterfaceTypeDefinition)
+- [ObjectTypeDefinition](https://spec.graphql.org/October2021/#ObjectTypeDefinition)
+- [OperationDefinition](https://spec.graphql.org/October2021/#OperationDefinition)
+- [ScalarTypeDefinition](https://spec.graphql.org/October2021/#ScalarTypeDefinition)
+- [UnionTypeDefinition](https://spec.graphql.org/October2021/#UnionTypeDefinition)
+- [VariableDefinition](https://spec.graphql.org/October2021/#VariableDefinition)
 
 > It's also possible to use a [`selector`](https://eslint.org/docs/developer-guide/selectors) that starts with `ASTNode` name
 >

package/docs/rules/no-anonymous-operations.md

@@ -1,8 +1,8 @@
 # `no-anonymous-operations`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Best Practices`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/no-anonymous-operations`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-case-insensitive-enum-values-duplicates.md

@@ -1,10 +1,10 @@
 # `no-case-insensitive-enum-values-duplicates`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
 
 🔧 The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#--fix) can automatically fix some of the problems reported by this rule.
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/no-case-insensitive-enum-values-duplicates`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-deprecated.md

@@ -1,6 +1,8 @@
 # `no-deprecated`
 
-- Category: `Best Practices`
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
+
+- Category: `Operations`
 - Rule name: `@graphql-eslint/no-deprecated`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/{avoid-duplicate-fields.md → no-duplicate-fields.md}

@@ -1,7 +1,9 @@
-# `avoid-duplicate-fields`
+# `no-duplicate-fields`
 
-- Category: `Stylistic Issues`
-- Rule name: `@graphql-eslint/avoid-duplicate-fields`
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
+
+- Category: `Operations`
+- Rule name: `@graphql-eslint/no-duplicate-fields`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
 
@@ -12,7 +14,7 @@ Checks for duplicate fields in selection set, variables in operation definition,
 ### Incorrect
 
 ```graphql
-# eslint @graphql-eslint/avoid-duplicate-fields: 'error'
+# eslint @graphql-eslint/no-duplicate-fields: 'error'
 
 query {
   user {
@@ -26,7 +28,7 @@ query {
 ### Incorrect
 
 ```graphql
-# eslint @graphql-eslint/avoid-duplicate-fields: 'error'
+# eslint @graphql-eslint/no-duplicate-fields: 'error'
 
 query {
   users(
@@ -43,7 +45,7 @@ query {
 ### Incorrect
 
 ```graphql
-# eslint @graphql-eslint/avoid-duplicate-fields: 'error'
+# eslint @graphql-eslint/no-duplicate-fields: 'error'
 
 query (
   $first: Int!
@@ -57,5 +59,5 @@ query (
 
 ## Resources
 
-- [Rule source](../../packages/plugin/src/rules/avoid-duplicate-fields.ts)
-- [Test source](../../packages/plugin/tests/avoid-duplicate-fields.spec.ts)
+- [Rule source](../../packages/plugin/src/rules/no-duplicate-fields.ts)
+- [Test source](../../packages/plugin/tests/no-duplicate-fields.spec.ts)

package/docs/rules/no-fragment-cycles.md

@@ -1,8 +1,8 @@
 # `no-fragment-cycles`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/no-fragment-cycles`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-hashtag-description.md

@@ -1,6 +1,8 @@
 # `no-hashtag-description`
 
-- Category: `Best Practices`
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
+
+- Category: `Schema`
 - Rule name: `@graphql-eslint/no-hashtag-description`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-root-type.md

@@ -1,6 +1,6 @@
 # `no-root-type`
 
-- Category: `Validation`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/no-root-type`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
@@ -45,6 +45,12 @@ The schema defines the following properties:
 
 ### `disallow` (array, required)
 
+The elements of the array can contain the following enum values:
+
+- `query`
+- `mutation`
+- `subscription`
+
 Additional restrictions:
 
 * Minimum items: `1`

package/docs/rules/{avoid-scalar-result-type-on-mutation.md → no-scalar-result-type-on-mutation.md}

@@ -1,7 +1,7 @@
-# `avoid-scalar-result-type-on-mutation`
+# `no-scalar-result-type-on-mutation`
 
-- Category: `Best Practices`
-- Rule name: `@graphql-eslint/avoid-scalar-result-type-on-mutation`
+- Category: `Schema`
+- Rule name: `@graphql-eslint/no-scalar-result-type-on-mutation`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
 
@@ -12,7 +12,7 @@ Avoid scalar result type on mutation type to make sure to return a valid state.
 ### Incorrect
 
 ```graphql
-# eslint @graphql-eslint/avoid-scalar-result-type-on-mutation: 'error'
+# eslint @graphql-eslint/no-scalar-result-type-on-mutation: 'error'
 
 type Mutation {
   createUser: Boolean
@@ -22,7 +22,7 @@ type Mutation {
 ### Correct
 
 ```graphql
-# eslint @graphql-eslint/avoid-scalar-result-type-on-mutation: 'error'
+# eslint @graphql-eslint/no-scalar-result-type-on-mutation: 'error'
 
 type Mutation {
   createUser: User!
@@ -31,5 +31,5 @@ type Mutation {
 
 ## Resources
 
-- [Rule source](../../packages/plugin/src/rules/avoid-scalar-result-type-on-mutation.ts)
-- [Test source](../../packages/plugin/tests/avoid-scalar-result-type-on-mutation.spec.ts)
+- [Rule source](../../packages/plugin/src/rules/no-scalar-result-type-on-mutation.ts)
+- [Test source](../../packages/plugin/tests/no-scalar-result-type-on-mutation.spec.ts)

package/docs/rules/no-typename-prefix.md

@@ -0,0 +1,37 @@
+# `no-typename-prefix`
+
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
+
+- Category: `Schema`
+- Rule name: `@graphql-eslint/no-typename-prefix`
+- Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
+- Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
+
+Enforces users to avoid using the type name in a field name while defining your schema.
+
+## Usage Examples
+
+### Incorrect
+
+```graphql
+# eslint @graphql-eslint/no-typename-prefix: 'error'
+
+type User {
+  userId: ID!
+}
+```
+
+### Correct
+
+```graphql
+# eslint @graphql-eslint/no-typename-prefix: 'error'
+
+type User {
+  id: ID!
+}
+```
+
+## Resources
+
+- [Rule source](../../packages/plugin/src/rules/no-typename-prefix.ts)
+- [Test source](../../packages/plugin/tests/no-typename-prefix.spec.ts)

package/docs/rules/no-undefined-variables.md

@@ -1,8 +1,8 @@
 # `no-undefined-variables`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/no-undefined-variables`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-unreachable-types.md

@@ -1,8 +1,10 @@
 # `no-unreachable-types`
 
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
+
 🔧 The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#--fix) can automatically fix some of the problems reported by this rule.
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/no-unreachable-types`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-unused-fields.md

@@ -2,7 +2,7 @@
 
 🔧 The `--fix` option on the [command line](https://eslint.org/docs/user-guide/command-line-interface#--fix) can automatically fix some of the problems reported by this rule.
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/no-unused-fields`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `true` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-unused-fragments.md

@@ -1,8 +1,8 @@
 # `no-unused-fragments`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/no-unused-fragments`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `true` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/no-unused-variables.md

@@ -1,8 +1,8 @@
 # `no-unused-variables`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/no-unused-variables`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/one-field-subscriptions.md

@@ -1,8 +1,8 @@
 # `one-field-subscriptions`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/one-field-subscriptions`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/overlapping-fields-can-be-merged.md

@@ -1,8 +1,8 @@
 # `overlapping-fields-can-be-merged`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/overlapping-fields-can-be-merged`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/possible-fragment-spread.md

@@ -1,8 +1,8 @@
 # `possible-fragment-spread`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/possible-fragment-spread`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/possible-type-extension.md

@@ -1,8 +1,8 @@
 # `possible-type-extension`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/possible-type-extension`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/provided-required-arguments.md

@@ -1,8 +1,8 @@
 # `provided-required-arguments`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` and `"plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Schema & Operations`
 - Rule name: `@graphql-eslint/provided-required-arguments`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/require-deprecation-date.md

@@ -1,6 +1,6 @@
 # `require-deprecation-date`
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/require-deprecation-date`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/require-deprecation-reason.md

@@ -1,8 +1,8 @@
 # `require-deprecation-reason`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/schema-recommended"` property in a configuration file enables this rule.
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/require-deprecation-reason`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/require-description.md

@@ -1,6 +1,6 @@
 # `require-description`
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/require-description`
 - Requires GraphQL Schema: `false` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)
@@ -12,7 +12,7 @@ Enforce descriptions in your type definitions.
 ### Incorrect
 
 ```graphql
-# eslint @graphql-eslint/require-description: ['error', { on: ['ObjectTypeDefinition', 'FieldDefinition'] }]
+# eslint @graphql-eslint/require-description: ['error', { types: true, overrides: { FieldDefinition: true } }]
 
 type someTypeName {
   name: String
@@ -22,7 +22,7 @@ type someTypeName {
 ### Correct
 
 ```graphql
-# eslint @graphql-eslint/require-description: ['error', { on: ['ObjectTypeDefinition', 'FieldDefinition'] }]
+# eslint @graphql-eslint/require-description: ['error', { types: true, overrides: { FieldDefinition: true } }]
 
 """
 Some type description
@@ -39,13 +39,42 @@ type someTypeName {
 
 The schema defines the following properties:
 
-### `on` (array)
+### `types` (boolean)
 
-The object is an array with all elements of the type `string`.
+Includes:
 
-Additional restrictions:
+- [ObjectTypeDefinition](https://spec.graphql.org/October2021/#ObjectTypeDefinition)
+- [InterfaceTypeDefinition](https://spec.graphql.org/October2021/#InterfaceTypeDefinition)
+- [EnumTypeDefinition](https://spec.graphql.org/October2021/#EnumTypeDefinition)
+- [ScalarTypeDefinition](https://spec.graphql.org/October2021/#ScalarTypeDefinition)
+- [InputObjectTypeDefinition](https://spec.graphql.org/October2021/#InputObjectTypeDefinition)
+- [UnionTypeDefinition](https://spec.graphql.org/October2021/#UnionTypeDefinition)
 
-* Minimum items: `1`
+### `overrides` (object)
+
+Configuration for precise `ASTNode`
+
+Properties of the `overrides` object:
+
+#### `ObjectTypeDefinition` (boolean)
+
+#### `InterfaceTypeDefinition` (boolean)
+
+#### `EnumTypeDefinition` (boolean)
+
+#### `ScalarTypeDefinition` (boolean)
+
+#### `InputObjectTypeDefinition` (boolean)
+
+#### `UnionTypeDefinition` (boolean)
+
+#### `FieldDefinition` (boolean)
+
+#### `InputValueDefinition` (boolean)
+
+#### `EnumValueDefinition` (boolean)
+
+#### `DirectiveDefinition` (boolean)
 
 ## Resources
 

package/docs/rules/require-field-of-type-query-in-mutation-result.md

@@ -1,6 +1,6 @@
 # `require-field-of-type-query-in-mutation-result`
 
-- Category: `Best Practices`
+- Category: `Schema`
 - Rule name: `@graphql-eslint/require-field-of-type-query-in-mutation-result`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/require-id-when-available.md

@@ -1,6 +1,8 @@
 # `require-id-when-available`
 
-- Category: `Best Practices`
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
+
+- Category: `Operations`
 - Rule name: `@graphql-eslint/require-id-when-available`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `true` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)

package/docs/rules/scalar-leafs.md

@@ -1,8 +1,8 @@
 # `scalar-leafs`
 
-✅ The `"extends": "plugin:@graphql-eslint/recommended"` property in a configuration file enables this rule.
+✅ The `"extends": "plugin:@graphql-eslint/operations-recommended"` property in a configuration file enables this rule.
 
-- Category: `Validation`
+- Category: `Operations`
 - Rule name: `@graphql-eslint/scalar-leafs`
 - Requires GraphQL Schema: `true` [ℹ️](../../README.md#extended-linting-rules-with-graphql-schema)
 - Requires GraphQL Operations: `false` [ℹ️](../../README.md#extended-linting-rules-with-siblings-operations)