Merge branch 'mw/milestone-state-graphql-docs' into 'master'

Add descriptions to MilestoneStateEnum

See merge request gitlab-org/gitlab!52494

app/graphql/types/milestone_state_enum.rb

@@ -2,7 +2,10 @@
 
 module Types
   class MilestoneStateEnum < BaseEnum
-    value 'active'
-    value 'closed'
+    graphql_name 'MilestoneStateEnum'
+    description 'Current state of milestone'
+
+    value 'active', 'Milestone is currently active'
+    value 'closed', 'Milestone is closed'
   end
 end

doc/api/graphql/reference/gitlab_schema.graphql

@@ -15718,8 +15718,18 @@ Identifier of Milestone.
 """
 scalar MilestoneID
 
+"""
+Current state of milestone
+"""
 enum MilestoneStateEnum {
+  """
+  Milestone is currently active
+  """
   active
+
+  """
+  Milestone is closed
+  """
   closed
 }
 

doc/api/graphql/reference/gitlab_schema.json

@@ -43272,20 +43272,20 @@
         {
           "kind": "ENUM",
           "name": "MilestoneStateEnum",
-          "description": null,
+          "description": "Current state of milestone",
           "fields": null,
           "inputFields": null,
           "interfaces": null,
           "enumValues": [
             {
               "name": "active",
-              "description": null,
+              "description": "Milestone is currently active",
               "isDeprecated": false,
               "deprecationReason": null
             },
             {
               "name": "closed",
-              "description": null,
+              "description": "Milestone is closed",
               "isDeprecated": false,
               "deprecationReason": null
             }

doc/api/graphql/reference/index.md

@@ -4950,10 +4950,12 @@ State of a GitLab merge request.
 
 ### MilestoneStateEnum
 
+Current state of milestone.
+
 | Value | Description |
 | ----- | ----------- |
-| `active` |  |
-| `closed` |  |
+| `active` | Milestone is currently active |
+| `closed` | Milestone is closed |
 
 ### MoveType