Merge branch '246162-graphql-issuemovelist-mutation-repositions-issues-incorrectly-2' into 'master'

Fix issues reordering fields description

See merge request gitlab-org/gitlab!41661

app/graphql/mutations/boards/issues/issue_move_list.rb

@@ -29,11 +29,11 @@ module Mutations
 
         argument :move_before_id, GraphQL::ID_TYPE,
                   required: false,
-                  description: 'ID of issue before which the current issue will be positioned at'
+                  description: 'ID of issue that should be placed before the current issue'
 
         argument :move_after_id, GraphQL::ID_TYPE,
                   required: false,
-                  description: 'ID of issue after which the current issue will be positioned at'
+                  description: 'ID of issue that should be placed after the current issue'
 
         def ready?(**args)
           if move_arguments(args).blank?

doc/api/graphql/reference/gitlab_schema.graphql

@@ -7927,12 +7927,12 @@ input IssueMoveListInput {
   iid: String!
 
   """
-  ID of issue after which the current issue will be positioned at
+  ID of issue that should be placed after the current issue
   """
   moveAfterId: ID
 
   """
-  ID of issue before which the current issue will be positioned at
+  ID of issue that should be placed before the current issue
   """
   moveBeforeId: ID
 

doc/api/graphql/reference/gitlab_schema.json

@@ -21905,7 +21905,7 @@
             },
             {
               "name": "moveBeforeId",
-              "description": "ID of issue before which the current issue will be positioned at",
+              "description": "ID of issue that should be placed before the current issue",
               "type": {
                 "kind": "SCALAR",
                 "name": "ID",
@@ -21915,7 +21915,7 @@
             },
             {
               "name": "moveAfterId",
-              "description": "ID of issue after which the current issue will be positioned at",
+              "description": "ID of issue that should be placed after the current issue",
               "type": {
                 "kind": "SCALAR",
                 "name": "ID",

doc/api/issues.md

@@ -1181,9 +1181,9 @@ PUT /projects/:id/issues/:issue_iid/reorder
 | Attribute   | Type    | Required | Description                          |
 |-------------|---------|----------|--------------------------------------|
 | `id`        | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user  |
-| `issue_iid` | integer | yes      | The internal ID of a project's issue |
-| `move_after_id` | integer | no | The ID of a project's issue to move this issue after |
-| `move_before_id` | integer | no | The ID of a project's issue to move this issue before |
+| `issue_iid` | integer | yes      | The internal ID of the project's issue |
+| `move_after_id` | integer | no | The ID of a project's issue that should be placed after this issue |
+| `move_before_id` | integer | no | The ID of a project's issue that should be placed before this issue |
 
 ```shell
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/issues/85/reorder?move_after_id=51&move_before_id=92"