Merge branch 'cablett-graphql-description-tweak' into 'master'

Fix graphql description

See merge request gitlab-org/gitlab!28534

app/graphql/resolvers/merge_requests_resolver.rb

@@ -4,11 +4,11 @@ module Resolvers
   class MergeRequestsResolver < BaseResolver
     argument :iid, GraphQL::STRING_TYPE,
               required: false,
-              description: 'The IID of the merge request, e.g., "1"'
+              description: 'IID of the merge request, for example `1`'
 
     argument :iids, [GraphQL::STRING_TYPE],
               required: false,
-              description: 'The list of IIDs of issues, e.g., [1, 2]'
+              description: 'Array of IIDs of merge requests, for example `[1, 2]`'
 
     type Types::MergeRequestType, null: true
 

doc/api/graphql/reference/gitlab_schema.graphql

@@ -6147,12 +6147,12 @@ type Project {
   """
   mergeRequest(
     """
-    The IID of the merge request, e.g., "1"
+    IID of the merge request, for example `1`
     """
     iid: String
 
     """
-    The list of IIDs of issues, e.g., [1, 2]
+    Array of IIDs of merge requests, for example `[1, 2]`
     """
     iids: [String!]
   ): MergeRequest
@@ -6177,12 +6177,12 @@ type Project {
     first: Int
 
     """
-    The IID of the merge request, e.g., "1"
+    IID of the merge request, for example `1`
     """
     iid: String
 
     """
-    The list of IIDs of issues, e.g., [1, 2]
+    Array of IIDs of merge requests, for example `[1, 2]`
     """
     iids: [String!]
 

doc/api/graphql/reference/gitlab_schema.json

@@ -18471,7 +18471,7 @@
               "args": [
                 {
                   "name": "iid",
-                  "description": "The IID of the merge request, e.g., \"1\"",
+                  "description": "IID of the merge request, for example `1`",
                   "type": {
                     "kind": "SCALAR",
                     "name": "String",
@@ -18481,7 +18481,7 @@
                 },
                 {
                   "name": "iids",
-                  "description": "The list of IIDs of issues, e.g., [1, 2]",
+                  "description": "Array of IIDs of merge requests, for example `[1, 2]`",
                   "type": {
                     "kind": "LIST",
                     "name": null,
@@ -18512,7 +18512,7 @@
               "args": [
                 {
                   "name": "iid",
-                  "description": "The IID of the merge request, e.g., \"1\"",
+                  "description": "IID of the merge request, for example `1`",
                   "type": {
                     "kind": "SCALAR",
                     "name": "String",
@@ -18522,7 +18522,7 @@
                 },
                 {
                   "name": "iids",
-                  "description": "The list of IIDs of issues, e.g., [1, 2]",
+                  "description": "Array of IIDs of merge requests, for example `[1, 2]`",
                   "type": {
                     "kind": "LIST",
                     "name": null,