Remove unnecessary GraphQL descriptions (#6105)

* Remove unnecessary GraphQL descriptions

* Fixes

.changeset/odd-windows-explode.md

@@ -0,0 +1,6 @@
+---
+'@keystone-next/fields': major
+'@keystone-next/keystone': major
+---
+
+Removed unnecessary descriptions on GraphQL types. 

docs/pages/docs/apis/graphql.mdx

@@ -24,37 +24,20 @@ This system will generate the following GraphQL API.
 
 ```graphql
 type Query {
-  """ Search for the User item with the matching ID. """
   User(where: UserWhereUniqueInput!): User
-
-  """ Search for all User items which match the where clause. """
   allUsers(where: UserWhereInput, search: String, orderBy: [UserOrderByInput!]! = [], first: Int, skip: Int! = 0): [User]
-
-  """ Perform a meta-query on all User items which match the where clause. """
   _allUsersMeta(where: UserWhereInput, search: String, orderBy: [UserOrderByInput!]! = [], first: Int, skip: Int! = 0): _QueryMeta
 }
 
 type Mutation {
-  """ Create a single User item. """
   createUser(data: UserCreateInput): User
-
-  """ Create multiple User items. """
   createUsers(data: [UsersCreateInput]): [User]
-
-  """ Update a single User item by ID. """
   updateUser(id: ID!, data: UserUpdateInput): User
-
-  """ Update multiple User items by ID. """
   updateUsers(data: [UsersUpdateInput]): [User]
-
-  """ Delete a single User item by ID. """
   deleteUser(id: ID!): User
-
-  """ Delete multiple User items by ID. """
   deleteUsers(ids: [ID!]): [User]
 }
 
-""" A keystone list """
 type User {
   id: ID!
   name: String
@@ -133,7 +116,6 @@ type _QueryMeta {
 
 ```graphql
 type Query {
-  """ Search for the User item with the matching ID. """
   User(where: UserWhereUniqueInput!): User
 }
 
@@ -151,7 +133,6 @@ type User {
 
 ```graphql
 type Query {
-  """ Search for all User items which match the where clause. """
   allUsers(where: UserWhereInput, search: String, orderBy: [UserOrderByInput!]! = [], first: Int, skip: Int! = 0): [User]
 }
 
@@ -261,7 +242,6 @@ type _QueryMeta {
 
 ```graphql
 type Mutation {
-  """ Create a single User item. """
   createUser(data: UserCreateInput): User
 }
 
@@ -279,7 +259,6 @@ type User {
 
 ```graphql
 type Mutation {
-  """ Create multiple User items. """
   createUsers(data: [UsersCreateInput]): [User]
 }
 
@@ -301,7 +280,6 @@ type User {
 
 ```graphql
 type Mutation {
-  """ Update a single User item by ID. """
   updateUser(id: ID!, data: UserUpdateInput): User
 }
 
@@ -319,7 +297,6 @@ type User {
 
 ```graphql
 type Mutation {
-  """ Update multiple User items by ID. """
   updateUsers(data: [UsersUpdateInput]): [User]
 }
 
@@ -342,7 +319,6 @@ type User {
 
 ```graphql
 type Mutation {
-  """ Delete a single User item by ID. """
   deleteUser(id: ID!): User
 }
 
@@ -356,7 +332,6 @@ type User {
 
 ```graphql
 type Mutation {
-  """ Delete multiple User items by ID. """
   deleteUsers(ids: [ID!]): [User]
 }
 

examples-staging/assets-cloud/schema.graphql

@@ -1,6 +1,3 @@
-"""
- A keystone list
-"""
 type Post {
   id: ID!
   title: String
@@ -178,9 +175,6 @@ input PostsCreateInput {
   data: PostCreateInput
 }
 
-"""
- A keystone list
-"""
 type Author {
   id: ID!
   name: String
@@ -236,20 +230,8 @@ input AuthorWhereInput {
   email_not_contains: String
   email_in: [String]
   email_not_in: [String]
-
-  """
-   condition must be true for all nodes
-  """
   posts_every: PostWhereInput
-
-  """
-   condition must be true for at least 1 node
-  """
   posts_some: PostWhereInput
-
-  """
-   condition must be false for all nodes
-  """
   posts_none: PostWhereInput
 }
 
@@ -310,71 +292,21 @@ scalar JSON
   )
 
 type Mutation {
-  """
-   Create a single Post item.
-  """
   createPost(data: PostCreateInput): Post
-
-  """
-   Create multiple Post items.
-  """
   createPosts(data: [PostsCreateInput]): [Post]
-
-  """
-   Update a single Post item by ID.
-  """
   updatePost(id: ID!, data: PostUpdateInput): Post
-
-  """
-   Update multiple Post items by ID.
-  """
   updatePosts(data: [PostsUpdateInput]): [Post]
-
-  """
-   Delete a single Post item by ID.
-  """
   deletePost(id: ID!): Post
-
-  """
-   Delete multiple Post items by ID.
-  """
   deletePosts(ids: [ID!]): [Post]
-
-  """
-   Create a single Author item.
-  """
   createAuthor(data: AuthorCreateInput): Author
-
-  """
-   Create multiple Author items.
-  """
   createAuthors(data: [AuthorsCreateInput]): [Author]
-
-  """
-   Update a single Author item by ID.
-  """
   updateAuthor(id: ID!, data: AuthorUpdateInput): Author
-
-  """
-   Update multiple Author items by ID.
-  """
   updateAuthors(data: [AuthorsUpdateInput]): [Author]
-
-  """
-   Delete a single Author item by ID.
-  """
   deleteAuthor(id: ID!): Author
-
-  """
-   Delete multiple Author items by ID.
-  """
   deleteAuthors(ids: [ID!]): [Author]
 }
 
 type Query {
-  """
-   Search for all Post items which match the where clause.
-  """
   allPosts(
     where: PostWhereInput! = {}
     search: String
@@ -384,15 +316,7 @@ type Query {
     first: Int
     skip: Int! = 0
   ): [Post!]
-
-  """
-   Search for the Post item with the matching ID.
-  """
   Post(where: PostWhereUniqueInput!): Post
-
-  """
-   Perform a meta-query on all Post items which match the where clause.
-  """
   _allPostsMeta(
     where: PostWhereInput! = {}
     search: String
@@ -406,10 +330,6 @@ type Query {
       reason: "This query will be removed in a future version. Please use postsCount instead."
     )
   postsCount(where: PostWhereInput! = {}): Int
-
-  """
-   Search for all Author items which match the where clause.
-  """
   allAuthors(
     where: AuthorWhereInput! = {}
     search: String
@@ -419,15 +339,7 @@ type Query {
     first: Int
     skip: Int! = 0
   ): [Author!]
-
-  """
-   Search for the Author item with the matching ID.
-  """
   Author(where: AuthorWhereUniqueInput!): Author
-
-  """
-   Perform a meta-query on all Author items which match the where clause.
-  """
   _allAuthorsMeta(
     where: AuthorWhereInput! = {}
     search: String