Add descriptions for PipelineStatusEnum

app/graphql/types/ci/pipeline_status_enum.rb

@@ -3,8 +3,24 @@
 module Types
   module Ci
     class PipelineStatusEnum < BaseEnum
+      descriptions = {
+        created: 'Pipeline has been created',
+        waiting_for_resource: 'A resource (for example, a runner) that the pipeline requires to run is unavailable',
+        preparing: 'Pipeline is preparing to run',
+        pending: 'Pipeline has not started running yet',
+        running: 'Pipeline is running',
+        failed: 'At least one stage of the pipeline failed',
+        success: 'Pipeline completed successfully',
+        canceled: 'Pipeline was canceled before completion',
+        skipped: 'Pipeline was skipped',
+        manual: 'Pipeline needs to be manually started',
+        scheduled: 'Pipeline is scheduled to run'
+      }
+
       ::Ci::Pipeline.all_state_names.each do |state_symbol|
-        value state_symbol.to_s.upcase, value: state_symbol.to_s
+        value state_symbol.to_s.upcase,
+              description: descriptions[state_symbol],
+              value: state_symbol.to_s
       end
     end
   end

doc/api/graphql/reference/index.md

@@ -7878,17 +7878,17 @@ Rotation length unit of an on-call rotation.
 
 | Value | Description |
 | ----- | ----------- |
-| `CANCELED` |  |
-| `CREATED` |  |
-| `FAILED` |  |
-| `MANUAL` |  |
-| `PENDING` |  |
-| `PREPARING` |  |
-| `RUNNING` |  |
-| `SCHEDULED` |  |
-| `SKIPPED` |  |
-| `SUCCESS` |  |
-| `WAITING_FOR_RESOURCE` |  |
+| `CANCELED` | Pipeline was canceled before completion. |
+| `CREATED` | Pipeline has been created. |
+| `FAILED` | At least one stage of the pipeline failed. |
+| `MANUAL` | Pipeline needs to be manually started. |
+| `PENDING` | Pipeline has not started running yet. |
+| `PREPARING` | Pipeline is preparing to run. |
+| `RUNNING` | Pipeline is running. |
+| `SCHEDULED` | Pipeline is scheduled to run. |
+| `SKIPPED` | Pipeline was skipped. |
+| `SUCCESS` | Pipeline completed successfully. |
+| `WAITING_FOR_RESOURCE` | A resource (for example, a runner) that the pipeline requires to run is unavailable. |
 
 ### `ProjectMemberRelation`