@graphql-eslint/eslint-plugin 3.0.0-alpha-0a66b90.0 → 3.0.0-alpha-2918431.0

package/docs/rules/known-directives.md

@@ -1,8 +1,8 @@
 # `known-directives`
 
-✅ 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-directives`
 - 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-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)
@@ -33,18 +33,32 @@ type User {
 
 ## Config Schema
 
+> It's possible to use a [`selector`](https://eslint.org/docs/developer-guide/selectors) that starts with allowed `ASTNode` names which are described below.
+>
+> Paste or drop code into the editor in [ASTExplorer](https://astexplorer.net) and inspect the generated AST to compose your selector.
+>
+> Example: pattern property `FieldDefinition[parent.name.value=Query]` will match only fields for type `Query`.
+
 The schema defines the following properties:
 
+### `allowLeadingUnderscore` (boolean)
+
+Default: `false`
+
+### `allowTrailingUnderscore` (boolean)
+
+Default: `false`
+
 ### `types`
 
 Includes:
 
-- [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)
+- `ObjectTypeDefinition`
+- `InterfaceTypeDefinition`
+- `EnumTypeDefinition`
+- `ScalarTypeDefinition`
+- `InputObjectTypeDefinition`
+- `UnionTypeDefinition`
 
 The object must be one of the following types:
 
@@ -55,51 +69,136 @@ The object must be one of the following types:
 
 Includes:
 
-- [FieldDefinition](https://spec.graphql.org/October2021/#FieldDefinition)
-- [InputValueDefinition](https://spec.graphql.org/October2021/#InputValueDefinition)
-- [VariableDefinition](https://spec.graphql.org/October2021/#VariableDefinition)
-- [Argument](https://spec.graphql.org/October2021/#Argument)
-- [DirectiveDefinition](https://spec.graphql.org/October2021/#DirectiveDefinition)
+- `FieldDefinition`
+- `InputValueDefinition`
+- `Argument`
+- `DirectiveDefinition`
 
 The object must be one of the following types:
 
 * `asString`
 * `asObject`
 
-### `allowLeadingUnderscore` (boolean)
+### `Argument`
 
-Default: `false`
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#Argument).
 
-### `allowTrailingUnderscore` (boolean)
+The object must be one of the following types:
 
-Default: `false`
+* `asString`
+* `asObject`
 
-### `overrides` (object)
-
-May contain the following `ASTNode` names:
-
-- [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
->
-> Example: pattern property `FieldDefinition[parent.name.value=Query]` will match only fields for type `Query`
+### `DirectiveDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#DirectiveDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `EnumTypeDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#EnumTypeDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `EnumValueDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#EnumValueDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `FieldDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#FieldDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `FragmentDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#FragmentDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `InputObjectTypeDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#InputObjectTypeDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `InputValueDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#InputValueDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `InterfaceTypeDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#InterfaceTypeDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `ObjectTypeDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#ObjectTypeDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `OperationDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#OperationDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `ScalarTypeDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#ScalarTypeDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
+
+### `UnionTypeDefinition`
+
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#UnionTypeDefinition).
+
+The object must be one of the following types:
+
+* `asString`
+* `asObject`
 
-Pattern properties of the `overrides` object:
+### `VariableDefinition`
 
-#### `^(Argument|DirectiveDefinition|EnumTypeDefinition|EnumValueDefinition|FieldDefinition|FragmentDefinition|InputObjectTypeDefinition|InputValueDefinition|InterfaceTypeDefinition|ObjectTypeDefinition|OperationDefinition|ScalarTypeDefinition|UnionTypeDefinition|VariableDefinition)(.+)?$`
+Read more about this kind on [spec.graphql.org](https://spec.graphql.org/October2021/#VariableDefinition).
 
 The object must be one of the following types:
 

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,15 +1,15 @@
 # `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)
 
-Disallow using root types for `read-only` or `write-only` schemas.
+Disallow using root types `mutation` and/or `subscription`.
 
 ## Usage Examples
 
-### Incorrect (`read-only` schema)
+### Incorrect
 
 ```graphql
 # eslint @graphql-eslint/no-root-type: ['error', { disallow: ['mutation', 'subscription'] }]
@@ -19,17 +19,7 @@ type Mutation {
 }
 ```
 
-### Incorrect (`write-only` schema)
-
-```graphql
-# eslint @graphql-eslint/no-root-type: ['error', { disallow: ['query'] }]
-
-type Query {
-  users: [User!]!
-}
-```
-
-### Correct (`read-only` schema)
+### Correct
 
 ```graphql
 # eslint @graphql-eslint/no-root-type: ['error', { disallow: ['mutation', 'subscription'] }]
@@ -45,6 +35,11 @@ The schema defines the following properties:
 
 ### `disallow` (array, required)
 
+The elements of the array can contain the following enum values:
+
+- `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)